No data is being reported
The OpenTelemetry export endpoint is misconfigured
OpenTelemetry apps default to exporting data tohttp://localhost:4318.
AppSignal requires a custom endpoint to send data to the AppSignal collector.
The AppSignal collector can run as a hosted or self-hosted type. Read our Hosted vs Self-hosted page for more information about the difference between these collector types.
Follow the help for the collector type your application uses below:
- Hosted collector
- Self-hosted collector, installed as a Linux package and Docker image
Hosted collector
When using the hosted collector, make sure to use the collector’s URL shown in the add app wizard as the OpenTelemetry exporter’s endpoint. In the add app wizard select the language your application uses that AppSignal supports for OpenTelemetry, or use the “More languages” option, to view the hosted collector endpoint. It may be in a code example, assigned to a variable namedendpoint.
The hosted collector’s format is as follows:
https://COLLECTOR-ID.REGION.appsignal-collector.net
OTEL_EXPORTER_OTLP_ENDPOINT environment variable or in the app itself, where OpenTelemetry is configured.
Refer to the language-specific installation guide your application is using for more detail.
Self-hosted collector
When using a self-hosted collector, the OpenTelemetry exporter endpoint needs to point to the location the collector is running. If the collector is running on the same host (installed using the Linux package) the hostname islocalhost.
If the collector runs in a Docker container or Kubernetes cluster, the hostname may differ based on the specified service name.
We recommend naming the service appsignal and updating the exporter’s endpoint to match the appsignal hostname.
- Hostname, several values are possible:
- Examples:
http://localhost:8099, orhttp://appsignal:8099on Docker.
http/https) should not be set as part of the OpenTelemetry exporter endpoint. Please refer to the installation guide for the language your application uses.
The exporter endpoint needs to be configured either via the OTEL_EXPORTER_OTLP_ENDPOINT environment variable or in the app itself, where OpenTelemetry is configured.
Refer to the language-specific installation guide your application is using for more detail.
Exporter endpoints
Some OpenTelemetry exporters may need to be configured per OpenTelemetry data type to specific endpoints. When configuring a trace/span exporter, use the trace endpoint, for metrics, use the metrics endpoint, etc. These endpoints on the AppSignal collector are:- Trace data:
/v1/tracesor,/v1/traces
- Metric data:
/v1/metricsor,/v1/metrics
- Log data:
/v1/logsor,/v1/logs
The OpenTelemetry export protocol is not set to http/protobuf
The AppSignal collector only supports the OpenTelemetry Protocol (OTLP) over HTTP with Protobuf encoding. Required config:- Protocol format:
http/protobuf
The self-hosted collector is not running or is unreachable
To send data to AppSignal, the self-hosted collector needs to have started correctly. Export errors visible in the application logs may indicate the collector isn’t running. To check if it’s running, check the collector logs. The collector logs can be found in:- The container logs for the Docker container installation method. Check your container manager for the best way to access container logs.
- The system logs for the Linux package installation method.