Azure Monitor OpenTelemetry Exporter client library for Java - version 1.0.0-beta.1

This client library provides support for exporting OpenTelemetry data to Azure Monitor. This package assumes your application is already instrumented with the OpenTelemetry SDK following the OpenTelemetry Specification.

Source code | Package (Maven) | API reference documentation | Product Documentation | Samples

Getting started

Prerequisites

For more information, please read introduction to Application Insights.

Include the Package

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>opentelemetry-exporters-azuremonitor</artifactId>
  <version>1.0.0-beta.1</version>
</dependency>

Authentication

Get the instrumentation key from the portal

In order to export telemetry data to Azure Monitor, you will need the instrumentation key to your Application Insights resource. To get your instrumentation key, go to Azure Portal, search for your resource. On the overview page of your resource, you will find the instrumentation key on the top right corner.

Creating exporter for Azure Monitor

AzureMonitorExporter azureMonitorExporter = new AzureMonitorExporterBuilder()
    .instrumentationKey("{instrumentation-key}")
    .buildExporter();

Exporting span data

The following example shows how to export a collection of available Spans to Azure Monitor through the AzureMonitorExporter

AzureMonitorExporter azureMonitorExporter = new AzureMonitorExporterBuilder()
    .instrumentationKey("{instrumentation-key}")
    .buildExporter();

CompletableResultCode resultCode = azureMonitorExporter.export(getSpanDataCollection());
System.out.println(resultCode.isSuccess());

Key concepts

For more information on the OpenTelemetry project, please review the OpenTelemetry Specifications .

Examples

More examples can be found in [samples][samples_code].

Troubleshooting

Enabling Logging

Azure SDKs for Java offer a consistent logging story to help aid in troubleshooting application errors and expedite their resolution. The logs produced will capture the flow of an application before reaching the terminal state to help locate the root issue. View the logging wiki for guidance about enabling logging.

Next steps

Learn more about Open Telemetry

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a [Contributor License Agreement (CLA)][cla] declaring that you have the right to, and actually do, grant us the rights to use your contribution.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For more information see the [Code of Conduct FAQ][coc_faq] or contact [opencode@microsoft.com][coc_contact] with any additional questions or comments.

  • Last updated on