-
Notifications
You must be signed in to change notification settings - Fork 660
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
adding instructions to port instrumentation #26
adding instructions to port instrumentation #26
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I like it. It's a good starting point, I think we could extend (in further PRs) the instructions about how to update the code to use the opentelemetry API.
Co-Authored-By: Mauricio Vásquez <mauricio@kinvolk.io>
README.md
Outdated
|
||
```bash | ||
mkdir -p instrumentors/jinja2/src/opentelemetry/ext/jinja2 | ||
git mv instrumentors/jinja2/*.py instrumentors/jinja2/src/opentelemetry/ext/jinja2 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We should not use ext
but instrumentors
.
_template/README.rst
Outdated
|
||
:: | ||
|
||
pip install opentelemetry-ext-<REPLACE ME> |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
pip install opentelemetry-ext-<REPLACE ME> | |
pip install opentelemetry-instrumentors-<REPLACE ME> |
_template/README.rst
Outdated
References | ||
---------- | ||
|
||
* `OpenTelemetry <REPLACE ME>/ Tracing <https://opentelemetry-python.readthedocs.io/en/latest/ext/<REPLACE ME>/<REPLACE ME>.html>`_ |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
* `OpenTelemetry <REPLACE ME>/ Tracing <https://opentelemetry-python.readthedocs.io/en/latest/ext/<REPLACE ME>/<REPLACE ME>.html>`_ | |
* `OpenTelemetry <REPLACE ME>/ Tracing <https://opentelemetry-python.readthedocs.io/en/latest/instrumentors/<REPLACE ME>/<REPLACE ME>.html>`_ |
_template/setup.py
Outdated
"opentelemetry_instrumentor": [ | ||
# REPLACE ME: the entrypoint for the instrumentor e.g | ||
# "sqlalchemy = opentelemetry.ext.sqlalchemy:SQLAlchemyInstrumentor" | ||
"<REPLACE ME> = opentelemetry.ext.<REPLACE>" |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"<REPLACE ME> = opentelemetry.ext.<REPLACE>" | |
"<REPLACE ME> = opentelemetry.instrumentors.<REPLACE>" |
_template/setup.py
Outdated
BASE_DIR = os.path.dirname(__file__) | ||
VERSION_FILENAME = os.path.join( | ||
# REPLACE ME: the path to the version file e.g | ||
# BASE_DIR, "src", "opentelemetry", "ext", "sqlalchemy", "version.py" |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
# BASE_DIR, "src", "opentelemetry", "ext", "sqlalchemy", "version.py" | |
# BASE_DIR, "src", "opentelemetry", "instrumentors", "sqlalchemy", "version.py" |
README.md
Outdated
5. Add `version.py` file and update it accordingly | ||
|
||
```bash | ||
mv instrumentors/jinja2/version.py instrumentors/jinja2/src/opentelemetry/ext/jinja2/version.py |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
mv instrumentors/jinja2/version.py instrumentors/jinja2/src/opentelemetry/ext/jinja2/version.py | |
mv instrumentors/jinja2/version.py instrumentors/jinja2/src/opentelemetry/instrumentors/jinja2/version.py |
_template/README.rst
Outdated
|
||
|pypi| | ||
|
||
.. |pypi| image:: https://badge.fury.io/py/opentelemetry-ext-<REPLACE ME>.svg |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
.. |pypi| image:: https://badge.fury.io/py/opentelemetry-ext-<REPLACE ME>.svg | |
.. |pypi| image:: https://badge.fury.io/py/opentelemetry-instrumentors-<REPLACE ME>.svg |
_template/README.rst
Outdated
|pypi| | ||
|
||
.. |pypi| image:: https://badge.fury.io/py/opentelemetry-ext-<REPLACE ME>.svg | ||
:target: https://pypi.org/project/opentelemetry-ext-<REPLACE ME>/ |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
:target: https://pypi.org/project/opentelemetry-ext-<REPLACE ME>/ | |
:target: https://pypi.org/project/opentelemetry-instrumentors-<REPLACE ME>/ |
_template/setup.cfg
Outdated
# limitations under the License. | ||
# | ||
[metadata] | ||
# opentelemetry-ext plus the name of the library being instrument e.g |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
# opentelemetry-ext plus the name of the library being instrument e.g | |
# opentelemetry-instrumentors plus the name of the library being instrument e.g |
_template/setup.cfg
Outdated
# | ||
[metadata] | ||
# opentelemetry-ext plus the name of the library being instrument e.g | ||
# name = opentelemetry-ext-sqlalchemy |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
# name = opentelemetry-ext-sqlalchemy | |
# name = opentelemetry-instrumentors-sqlalchemy |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM
Co-Authored-By: Hector Hernandez <39923391+hectorhdzg@users.noreply.github.com>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM
Auto discover namespace packages.
Adding some instructions on how to get started porting instrumentation. More information to be added later once we have travis sorted out for testing.