https://github.com/wavefronthq/opentelemetry-examples
https://github.com/wavefronthq/opentelemetry-examples
Last synced: 9 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/wavefronthq/opentelemetry-examples
- Owner: wavefrontHQ
- Created: 2021-11-24T19:02:10.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-06-18T16:32:36.000Z (almost 2 years ago)
- Last Synced: 2025-04-11T05:06:53.762Z (about 1 year ago)
- Language: Go
- Size: 2.4 MB
- Stars: 17
- Watchers: 5
- Forks: 8
- Open Issues: 33
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Sending Data to Our Service
If you use OpenTelemetry, you can configure the application to send traces or metrics to VMware Aria Operations for Applications (formerly known as Tanzu Observability by Wavefront) using the Wavefront proxy.
## Configure the Wavefront Proxy
1. [Install the Wavefront proxy](https://docs.wavefront.com/proxies_installing.html).
1. Configure the Wavefront proxy to send OpenTelemetry data to our service. See the [Wavefront proxy settings for OpenTelemetry](https://docs.wavefront.com/proxies_configuring.html#opentelemetry-proxy-properties).
* **Trace data**: Port 4317 (recommended) with `otlpGrpcListenerPorts` **or** port 4318 (recommended) with `otlpHttpListenerPorts`.
* **Metrics data**:
* Port 4317 (recommended) with `otlpGrpcListenerPorts` **or** port 4318 (recommended) with `otlpHttpListenerPorts`.
* To receive the OpenTelemetry resource attributes that your application sends for metrics data, set `otlpResourceAttrsOnMetricsIncluded` to `true`.
**Note**: Be aware that setting this to `true` increases the chance of metrics exceeding the [annotations count limit on your cluster](https://docs.wavefront.com/wavefront_limits.html#default-customer-specific-limits), causing the metrics to be dropped by the Wavefront proxy.
## Send and View Data
Follow these steps to send traces or metrics to our service:
1. Configure your application to send trace data to the Wavefront proxy.
By default, OpenTelemetry SDKs send data over gRPC to `http://localhost:4317`.
1. Explore trace and metrics data:
* **Trace data**:
You can use our [tracing dashboards](https://docs.wavefront.com/tracing_basics.html#visualize-distributed-tracing-data) to visualize the requests as traces, which consists of a hierarchy of spans. This visualization helps you pinpoint where the request is spending most of its time and discover problems.
* **Metrics data**:
Explore the metrics data you sent with charts and dashboards.
* Try out the [Dashboards and Charts tutorial](https://docs.wavefront.com/tutorial_dashboards.html), or watch the video on that page to get started.
* Create [dashboards](https://docs.wavefront.com/ui_dashboards.html) and [charts](https://docs.wavefront.com/ui_charts.html) using the data you sent to our service.
You need to have the required permissions to do these tasks.
## Metrics Conversion
The OpenTelemetry metrics your applications send are converted to [our data format](https://docs.wavefront.com/wavefront_data_format.html) as follows:
For more information on our metrics, see [Metric Types](https://docs.wavefront.com/metric_types.html).
## Tutorials
Our OpenTelemetry GitHub repository includes specific examples for Java, Python, .NET, and more.
* If you are on our Documentation, expand the tutorials section under OpenTelemetry, and try out a tutorial.
* If you are on the GitHub repository, for example, go to the `java-examples` folder and follow the steps in the README to instrument Java Apps with OpenTelemetry.
## Getting Support
* If you run into any issues with the examples, let us know by creating a GitHub issue on our [OpenTelemetry GitHub repository](https://github.com/wavefrontHQ/opentelemetry-examples).
* If you didn't find the information you are looking for in our [Documentation](https://docs.wavefront.com/), create a GitHub issue or PR in our [docs repository](https://github.com/wavefrontHQ/docs).