Naar hoofdinhoud gaan
Wanneer er geen gegevens van uw app naar AppSignal worden gerapporteerd, controleer dan de onderstaande veelvoorkomende problemen.

Er worden geen gegevens gerapporteerd

Het OpenTelemetry-export-endpoint is verkeerd geconfigureerd

OpenTelemetry-apps exporteren standaard gegevens naar http://localhost:4318. AppSignal vereist een aangepast endpoint om gegevens naar de AppSignal collector te sturen. De AppSignal collector kan als hosted of self-hosted type draaien. Lees onze pagina Hosted versus Self-hosted voor meer informatie over het verschil tussen deze collectortypen. Volg de hulp voor het collectortype dat uw applicatie hieronder gebruikt:

Hosted collector

Wanneer u de hosted collector gebruikt, zorg er dan voor dat u de URL van de collector die wordt getoond in de app-toevoeg-wizard gebruikt als endpoint van de OpenTelemetry-exporter. Selecteer in de app-toevoeg-wizard de taal die uw applicatie gebruikt en die AppSignal voor OpenTelemetry ondersteunt, of gebruik de optie “More languages”, om het endpoint van de hosted collector te bekijken. Het kan in een codevoorbeeld staan, toegewezen aan een variabele met de naam endpoint. Het formaat van de hosted collector is als volgt:
  • https://COLLECTOR-ID.REGION.appsignal-collector.net
Het exporter-endpoint moet worden geconfigureerd via de omgevingsvariabele OTEL_EXPORTER_OTLP_ENDPOINT of in de app zelf, waar OpenTelemetry is geconfigureerd. Raadpleeg de taalspecifieke installatiehandleiding die uw applicatie gebruikt voor meer details.

Self-hosted collector

Wanneer u een self-hosted collector gebruikt, moet het OpenTelemetry-exporter-endpoint verwijzen naar de locatie waar de collector draait. Als de collector op dezelfde host draait (geïnstalleerd via het Linux-pakket), dan is de hostname localhost. Als de collector in een Docker-container of Kubernetes-cluster draait, kan de hostname verschillen op basis van de opgegeven servicenaam. Wij raden aan om de service appsignal te noemen en het endpoint van de exporter bij te werken zodat deze overeenkomt met de hostname appsignal.
  • Hostname, meerdere waarden zijn mogelijk:
  • Voorbeelden:
    • http://localhost:8099, of http://appsignal:8099 op Docker.
Voor sommige talen mag in de OpenTelemetry SDK het URI-schema (http/https) niet als onderdeel van het OpenTelemetry-exporter-endpoint worden ingesteld. Raadpleeg de installatiehandleiding voor de taal die uw applicatie gebruikt. Het exporter-endpoint moet worden geconfigureerd via de omgevingsvariabele OTEL_EXPORTER_OTLP_ENDPOINT of in de app zelf, waar OpenTelemetry is geconfigureerd. Raadpleeg de taalspecifieke installatiehandleiding die uw applicatie gebruikt voor meer details.

Exporter-endpoints

Sommige OpenTelemetry-exporters moeten mogelijk per OpenTelemetry-gegevenstype op specifieke endpoints worden geconfigureerd. Wanneer u een trace/span-exporter configureert, gebruik dan het trace-endpoint; voor metrieken het metric-endpoint, enz. Deze endpoints op de AppSignal collector zijn:
  • Trace-gegevens:
    • /v1/traces of,
    • /v1/traces
  • Metric-gegevens:
    • /v1/metrics of,
    • /v1/metrics
  • Loggegevens:
    • /v1/logs of,
    • /v1/logs

Het OpenTelemetry-exportprotocol is niet ingesteld op http/protobuf

De AppSignal collector ondersteunt alleen het OpenTelemetry-protocol (OTLP) via HTTP met Protobuf-codering. Vereiste configuratie:
  • Protocolformaat: http/protobuf
Als OpenTelemetry in uw app gRPC of JSON als exportformaat gebruikt, werk de configuratie dan bij om het HTTP/protobuf-formaat te gebruiken. Om het exporter-protocolformaat te configureren, volgt u de installatiestappen voor de taal die uw applicatie gebruikt.

De self-hosted collector draait niet of is niet bereikbaar

Om gegevens naar AppSignal te sturen, moet de self-hosted collector correct zijn gestart. Export-fouten die zichtbaar zijn in de logs van de applicatie kunnen erop wijzen dat de collector niet draait. Om te controleren of hij draait, raadpleegt u de logs van de collector. De logs van de collector vindt u in: Als de collector draait maar niet bereikbaar is, controleer dan de interne netwerkinstellingen om te zien of de applicatie de host van de collector kan bereiken.

Ontbrekende of onvolledige gegevens gerapporteerd

Als u slechts een deel van de gegevens ziet en meer gegevens mist over wat uw applicatie doet, ligt dat waarschijnlijk aan ontbrekende OpenTelemetry-instrumentatie in uw applicatie. OpenTelemetry instrumenteert niet alles automatisch out-of-the-box. Om gegevens van specifieke frameworks en libraries te verzamelen, moet u aanvullende instrumentatie-libraries installeren en configureren. Om meer gegevens te rapporteren, installeert u de juiste OpenTelemetry-instrumentatie-libraries voor de bijbehorende libraries die in uw applicatie worden gebruikt. Raadpleeg de handleiding voor het toevoegen van aanvullende OpenTelemetry-instrumentatie voor de taal van uw applicatie voor instructies over het installeren van meer instrumentatiepakketten.