Pular para o conteúdo principal
Certifique-se de instalar o AppSignal collector antes de prosseguir com estas instruções.

​
Configure o SDK do OpenTelemetry

Siga as instruções na documentação do OpenTelemetry para configurar o SDK para a sua linguagem. Você deve configurar o SDK do OpenTelemetry para exportar os dados ao AppSignal collector. O AppSignal collector espera receber dados no formato do protocolo OTLP sobre HTTP. Geralmente é necessário instalar um pacote adicional do OpenTelemetry para exportar em um formato específico. O AppSignal collector atualmente não suporta dados de log, então é recomendado desabilitar o exporter de log para silenciar erros de exportação. Por padrão, o AppSignal collector escuta na porta 8099. Os exporters do OpenTelemetry devem ser configurados para enviar dados a estes endpoints do collector:
  • Traces: http://localhost:8099/v1/traces
  • Métricas: http://localhost:8099/v1/metrics
  • Logs: http://localhost:8099/v1/logs
Muitos pacotes de exporter do OpenTelemetry definem automaticamente o caminho de exportação como /v1/traces para traces, /v1/metrics para métricas e /v1/logs para logs, então você só precisaria especificar localhost:8099 como endpoint. No entanto, para algumas linguagens, pode ser necessário especificar o caminho inteiro. Se você está rodando o AppSignal collector em um host diferente, substitua localhost pelo endereço do seu AppSignal collector.

​
Configure o recurso do OpenTelemetry

O AppSignal collector exige que certos atributos estejam presentes no recurso do OpenTelemetry. Configure o recurso do OpenTelemetry com o SDK com os seguintes atributos obrigatórios:
  • appsignal.config.name: O nome da aplicação no AppSignal.
  • appsignal.config.environment: O ambiente da aplicação no AppSignal.
  • appsignal.config.push_api_key: A push API key a ser usada para enviar dados ao AppSignal. Pode ser a mesma Push API key que foi configurada ao instalar o AppSignal collector.
  • appsignal.config.revision: Cria implantações automaticamente no AppSignal especificando a revisão do app.
  • appsignal.config.language_integration: Define o nome da linguagem de programação. Isso nos ajuda a reconhecer a linguagem de programação que está sendo usada e a melhorar como nossos servidores interpretam os dados. Exemplos de valores: “python”, “rust”, “ruby”, “elixir”, “go”, “node.js”.
  • service.name: O nome do serviço. Veja abaixo para mais detalhes.
  • host.name: O nome do host.
Veja também nossa página de opções de configuração para uma lista de todas as opções de configuração suportadas. Se você já tem uma aplicação que usa o mesmo nome e ambiente, reportada por um dos nossos pacotes de integração de linguagem existentes, por favor use outro nome e/ou ambiente. Os dados reportados pelo AppSignal são exibidos em novos elementos de UI e páginas que não são compatíveis com os dados reportados pelos nossos pacotes de integração. Recomendamos reportar os dados de OpenTelemetry da aplicação para uma nova aplicação no AppSignal para que a UI não fique tão confusa.

​
Escolhendo um nome de serviço

Escolha um nome de serviço para o seu app que torne cada componente ou serviço facilmente reconhecível. Esse nome de serviço será usado para agrupar namespaces por serviço. Os namespaces resultantes são formatados assim: <service name>/<namespace> Se o nome do serviço for “My service name” e o namespace for “admin”, o namespace resultante no AppSignal.com se torna: “My service namespace/admin” A parte importante na nomeação é que ela faça sentido para você e sua equipe. Um nome de serviço pode ser o nome da aplicação, sua finalidade ou o nome do framework usado.