Naar hoofdinhoud gaan
Zorg ervoor dat u de AppSignal collector installeert voordat u verdergaat met deze instructies.

​
Configureer de OpenTelemetry SDK

Volg de instructies in de OpenTelemetry-documentatie om de SDK voor uw taal in te stellen. U dient de OpenTelemetry SDK te configureren om de gegevens naar de AppSignal collector te exporteren. De AppSignal collector verwacht gegevens die worden verzonden in het OTLP-protocolformaat over HTTP. Vaak is het nodig om een aanvullend OpenTelemetry-pakket te installeren om in een specifiek formaat te exporteren. De AppSignal collector ondersteunt momenteel geen logging-gegevens, dus het wordt aanbevolen om de logging-exporter uit te schakelen om export-fouten te onderdrukken. Standaard luistert de AppSignal collector op poort 8099. De OpenTelemetry-exporters moeten worden geconfigureerd om gegevens naar deze endpoints op de collector te sturen:
  • Traces: http://localhost:8099/v1/traces
  • Metrieken: http://localhost:8099/v1/metrics
  • Logs: http://localhost:8099/v1/logs
Veel OpenTelemetry-exporterpakketten stellen het exportpad automatisch in op /v1/traces voor traces, /v1/metrics voor metrieken en /v1/logs voor logs, dus u hoeft alleen localhost:8099 als endpoint op te geven. Voor sommige talen kan het echter nodig zijn om het volledige pad op te geven. Als u de AppSignal collector op een andere host uitvoert, vervang dan localhost door het adres van uw AppSignal collector.

​
Configureer de OpenTelemetry-resource

De AppSignal collector vereist dat bepaalde attributen aanwezig zijn in de OpenTelemetry-resource. Configureer de OpenTelemetry-resource met de SDK met de volgende vereiste attributen:
  • appsignal.config.name: De naam van de applicatie in AppSignal.
  • appsignal.config.environment: De omgeving van de applicatie in AppSignal.
  • appsignal.config.push_api_key: De push API-sleutel die wordt gebruikt om gegevens naar AppSignal te sturen. Dit kan dezelfde Push API-sleutel zijn die is geconfigureerd bij het installeren van de AppSignal collector.
  • appsignal.config.revision: Maak automatisch deploys aan in AppSignal door de app-revisie op te geven.
  • appsignal.config.language_integration: Stel de naam van de programmeertaal in. Dit helpt ons de gebruikte programmeertaal te herkennen en verbetert hoe onze servers de gegevens interpreteren. Voorbeeldwaarden: “python”, “rust”, “ruby”, “elixir”, “go”, “node.js”.
  • service.name: De servicenaam. Zie hieronder voor meer details.
  • host.name: De naam van de host.
Zie ook onze pagina met configuratieopties voor een lijst met alle ondersteunde configuratieopties. Als u al een applicatie hebt die dezelfde naam en omgeving gebruikt en die wordt gerapporteerd door een van onze bestaande taalintegratiepakketten, gebruik dan een andere naam en/of omgeving. De door AppSignal gerapporteerde gegevens worden weergegeven in nieuwe UI-elementen en pagina’s die niet compatibel zijn met de gegevens die door onze integratiepakketten worden gerapporteerd. Wij raden aan om de OpenTelemetry-gegevens van de applicatie naar een nieuwe AppSignal-applicatie te rapporteren, zodat de UI niet te verwarrend wordt.

​
Een servicenaam kiezen

Kies een servicenaam voor uw app waardoor elk onderdeel of elke service gemakkelijk te herkennen is. Deze servicenaam wordt gebruikt om namespaces per service te groeperen. De resulterende namespaces zijn als volgt opgemaakt: <service name>/<namespace> Als de servicenaam “My service name” is en de namespace “admin”, dan wordt de resulterende namespace op AppSignal.com: “My service namespace/admin” Het belangrijkste bij het naamgeven is dat het voor u en uw team logisch is. Een servicenaam kan de naam van de applicatie zijn, het doel ervan, of de naam van het gebruikte framework.