Integrando com rastreios do OpenTelemetry

Suporte às definições do ` OpenTelemetry ` para traços

Instana pode se integrar perfeitamente aos traços d OpenTelemetry. Instana correlaciona os traços do ` OpenTelemetry ` com os traços gerados pelo ` Instana ` que utilizam o contexto de rastreamento padrão do ` W3C `.

Instana suporta definições frequentemente utilizadas nas Convenções Semânticas de Rastreamento e nas Convenções Semânticas de Recursos do OpenTelemetry. Instana suporta os seguintes atributos, definidos nas Convenções Semânticas da OpenTelemetry.

Atributos de extensão:

- peer.service
- net.peer.ip
- net.peer.name
- net.peer.port
- http.method
- http.url
- http.scheme
- http.host
- http.target
- http.status_code
- http.route
- http.user_agent
- db.system
- db.user
- db.statement
- db.operation
- db.name
- db.connection_string
- messaging.system
- messaging.operation
- messaging.destination
- rpc.system
- rpc.service
- rpc.method
- faas.execution
- faas.trigger
- faas.coldstart
Nota: Instana identifica tecnologias específicas, como MySQL,, Redis e Kafka, para os componentes de banco de dados e mensagens do OpenTelemetry. Para identificar a tecnologia de um intervalo de banco de dados, esse intervalo deve possuir o atributo db.system. Para obter mais informações sobre os valores possíveis do db.system atributo, consulte as Convenções Semânticas para Chamadas de Banco de Dados. Para identificar a tecnologia de um intervalo de mensagens, esse intervalo deve possuir o atributo messaging.system. Para obter mais informações sobre os valores possíveis do messaging.system atributo, consulte as Convenções Semânticas para Chamadas de Mensagens.

Atributos de Recurso:

- service.name
- service.instance.id
- container.id
- process.pid
- telemetry.sdk.language
- host.name
- host.id
- cloud.provider
- faas.id
- device.id
- process.runtime.version
- container.name
- container.runtime
- container.image.name
- container.image.tag
- faas.version

Analisando chamadas do ` OpenTelemetry `

OpenTelemetry está integrado à tecnologia AutoTrace da Instana. Se a opção “ OpenTelemetry ” estiver ativada, os spans de um rastreamento gerado por aplicativos serão tratados da mesma forma que os spans provenientes dos rastreadores “ Instana ”.

Para filtrar chamadas de OpenTelemetry,, defina a consulta de filtro com os atributos de recurso OpenTelemetry, service.name e is present. Configure essa consulta de filtro porque a especificação OpenTelemetry para convenções semânticas de recurso requer o atributo de recurso OpenTelemetry . service.name O OpenTelemetry tem várias maneiras de especificar o nome do serviço Para obter mais informações, consulte a documentação oficial doOpenTelemetry

Cada atributo OpenTelemetry ou atributo de recurso é representado com as tags a seguir:

  • Tags dinâmicas: essas tags são calculadas a partir de todos os atributos OpenTelemetry enviados para Instana e que estão presentes no catálogo de tags de chamada. É possível procurar facilmente as tags dinâmicas por nome, como http.method, diretamente do catálogo de tags. O número de tags dinâmicas que são colocadas no catálogo de tags é limitado a 500 nomes de atributos diferentes. Se você exceder esse limite, use apenas as tags estáticas para filtrar e agrupar, porque elas não têm essa limitação

    Tags dinâmicas do OpenTelemetry

  • Tags estáticas: essas tags fornecem acesso a todos os atributos de OpenTelemetry ou aos atributos do recurso OpenTelemetry que são enviados para Instana. Para filtrar ou agrupar por tags estáticas, você deve primeiro selecionar uma tag d OpenTelemetry ou uma tag de recurso d OpenTelemetry e, em seguida, especificar o nome do atributo como sua chave.

    Tags estáticas do OpenTelemetry

Observação: Se você ultrapassar o limite de 500 atributos do tipo “ OpenTelemetry ”, verifique a convenção de nomenclatura dos seus atributos personalizados do tipo “ OpenTelemetry ”. Por exemplo, se você quiser acompanhar testes A/B, em vez de criar um novo atributo para cada usuário, como user-123-ab-test=a, você pode usar os dois atributos, user-id=123 e ab-test=a. Ao usar duas tags distintas, você pode filtrar ou agrupar facilmente seus dados, mantendo baixo o número total de tags diferentes do OpenTelemetry.

Limitações conhecidas

  • Instana não suporta a combinação do propagador de contexto padrão do ` Instana ` com outros propagadores de contexto que não sejam o ` W3C Trace Context`. W3C O Trace Context é o propagador de contexto padrão do ` OpenTelemetry `.