Dynatrace Metric Exporter for OpenTelemetry
Project description
Dynatrace OpenTelemetry Metrics Exporter for Python
This exporter is based on the OpenTelemetry Metrics SDK for Python, which is currently in an alpha state and neither considered stable nor complete as of this writing. As such, this exporter is not intended for production use until the underlying OpenTelemetry Metrics API and SDK are stable. See open-telemetry/opentelemetry-python for the current state of the OpenTelemetry SDK for Python.
Getting started
Usage
The general setup of OpenTelemetry Python is explained in the official Getting Started Guide.
# configure API endpoint and authentication token
exporter = DynatraceMetricsExporter(endpoint_url, api_token)
# setup metrics export pipeline
metrics.set_meter_provider(MeterProvider())
meter = metrics.get_meter(__name__)
metrics.get_meter_provider().start_pipeline(meter, exporter, push_interval_sec)
# crate a counter instrument and provide the first data point
counter = meter.create_counter(
name="MyCounter",
description="Description of MyCounter",
unit="1",
value_type=int
)
counter.add(25, {"dimension-1", "value-1"})
Example
To run the example, clone this repository and change to the opentelemetry-metric-python
folder, then run:
pip install . # install the Dynatrace exporter
export LOGLEVEL=DEBUG # (optional) Set the log level to debug to see more output (default is INFO)
python example/basic_example.py
A more complete setup routine can be found here, including installing inside a virtual environment and getting required packages.
If you just want to see it in action, it should be sufficient to run example/install_and_run.sh
from the root folder.
This script will install Python, set up a virtual environment, pull in all the required packages and run the example.
The example also offers a simple CLI. Run python example/basic_example.py -h
to get more information.
Configuration
The exporter allows for configuring the following settings by passing them to the constructor:
Dynatrace API Endpoint
The endpoint to which the metrics are sent is specified using the endpoint_url
parameter.
Given an environment ID myenv123
on Dynatrace SaaS, the metrics ingest endpoint would be https://myenv123.live.dynatrace.com/api/v2/metrics/ingest
.
If a OneAgent is installed on the host, it can provide a local endpoint for providing metrics directly without the need for an API token.
This feature is currently in an Early Adopter phase and has to be enabled as described in the OneAgent metric API documentation.
Using the local API endpoint, the host ID and host name context are automatically added to each metric as dimensions.
The default metric API endpoint exposed by the OneAgent is http://localhost:14499/metrics/ingest
.
If no endpoint is set and a OneAgent is running on the host, metrics will be exported to it automatically using the OneAgent with no endpoint or API token configuration required.
Dynatrace API Token
The Dynatrace API token to be used by the exporter is specified using the api_token
parameter and could, for example, be read from an environment variable.
Creating an API token for your Dynatrace environment is described in the Dynatrace API documentation.
The scope required for sending metrics is the Ingest metrics
scope in the API v2 section:
Metric Key Prefix
The prefix
parameter specifies an optional prefix, which is prepended to each metric key, separated by a dot (<prefix>.<namespace>.<name>
).
Default Dimensions
The default_dimensions
parameter can be used to optionally specify a list of key/value pairs, which will be added as additional dimensions to all data points.
Dimension keys are unique, and labels on instruments will overwrite the default dimensions if key collisions appear.
Export OneAgent Metadata
If running on a host with a running OneAgent, setting the export_oneagent_metadata
option to True
will export metadata collected by the OneAgent to the Dynatrace endpoint.
If no Dynatrace API endpoint is set, the default exporter endpoint will be the OneAgent endpoint, and this option will be set automatically.
Therefore, if no endpoint is specified, we assume a OneAgent is running and export to it, including metadata.
More information on the underlying OneAgent feature that is used by the exporter can be found in the
Dynatrace documentation.
Dimensions precedence
When specifying default dimensions, labels and OneAgent metadata enrichment, the precedence of dimensions with the same key is as follows:
Default dimensions are overwritten by labels passed to instruments, which in turn are overwritten by the OneAgent dimensions (even though the likeliness of a collision here is very low, since the OneAgent metadata only contains Dynatrace reserved dimensions starting with dt.*
).
Development
Requirements
Just tox
Running tests and lint
Test all supported python versions: tox
Test all supported python versions in parallel: tox -p
A particular python version: tox -e 38
Current python version: tox -e py
Lint: tox -e lint
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for opentelemetry-exporter-dynatrace-metrics-0.1.0b0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | cc7de4f6a9b35dccbf476a401d69f77e1083f920973a96ef6fb42db4033dcd9a |
|
MD5 | 7e2a49e6f1357ea1b4cc81da6cc3eee8 |
|
BLAKE2b-256 | 66c615be88078784dd06c3f1bca18bc79c36c8c6dd53a85d4665c95444ac0f46 |
Hashes for opentelemetry_exporter_dynatrace_metrics-0.1.0b0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 26ebb35e5e4cc9e01965abc265aa722ed558d3dbf545b72dfe32e0ad8de737fe |
|
MD5 | b674d9b88fc5ba7ae564bb7f050f55b9 |
|
BLAKE2b-256 | f57c01eeff466845d2a51363f333d35d3208cf1cb19062ac82d6badda4a2844e |