Intégration aux journaux OpenTelemetry

Modifier en ligne

Pour importer des journaux dans Instana via OpenTelemetry,, vous aurez peut-être besoin d'un module complémentaire ou d'une configuration supplémentaire. Pour plus d'informations, consultez la section « Conditions relatives aux licences et aux droits d'accès ».

Si l'agent hôte reçoit les données de journal OpenTelemetry , il affiche des exceptions mineures. Les journaux de l' OpenTelemetry sont importés dans le backend Instana de la manière suivante :

Envoyez les journaux directement au otlp-acceptor backend Instana via le protocole OTLP ou via le collecteur OpenTelemetry.
Importez les journaux à l'aide de l'agent « Instana », qui collecte les données pour Instana.

Modèle de données des journaux Opentelemetry

Modifier en ligne

Dans OpenTelemetry, un enregistrement se compose des champs suivants :


Nom de zone	Description
Horodatage	Heure à laquelle l'événement s'est produit.
ObservedTimestamp	Heure à laquelle l'événement a été observé.
TraceId	ID trace de la demande.
SpanId	ID de plage de la demande.
TraceFlags	Indicateur de trace W3C .
SeverityText	Texte de gravité ou niveau de journalisation.
SeverityNumber	Valeur numérique de la gravité.
Corps	Corps de l'enregistrement de journal.
Ressource	Décrit la source du journal.
InstrumentationScope	Décrit le groupe de métriques, de traces ou d'enregistrements de journal dans la même fonction ou la même partie de la ressource qui a émis le journal.
Attributs	Informations supplémentaires sur l'événement.

Source : OpenTelemetry Définition des enregistrements de journal

Les champs suivants servent à transformer les données du journal d' OpenTelemetry pour Instana :

Les champs TraceId, SpanId et Body sont intégrés tels quels.
Le champ « Timestamp » pris en compte pour la journalisation correspond à l'horodatage enregistré lors de l'ingestion des enregistrements de journaux dans l' Instana.
Le niveau de journalisation est déterminé principalement par la zone SeverityText et la zone SeverityNumber en tant que rétromigration. Si aucun niveau de journalisation ne peut être identifié à partir des zones SeverityText et SeverityNumber , le niveau de journalisation est défini sur UNKNOWN.
La zone Ressource permet d'identifier l'entité, le flux d'E-S et les informations d'hôte associées au journal.
Les attributs sont pris en charge sous forme de paires clé-valeur via les balises personnalisées disponibles sur Instana.
Les attributs d'exception exception.type, exception.message, et exception.stacktrace dans le champ Attributs sont également pris en charge dans Instana.

L'identification de l'hôte ou de l'entité est requise pour que Instana accepte les journaux de OpenTelemetry.

Pour répondre à cette exigence, utilisez l'une des options suivantes :

Configurez l'un des attributs suivants dans le champ « Ressource » des journaux :

process.id
faas.id
service.instance.id
container.id
aws.ecs.container.arn
k8s.job.uid
k8s.cronjob.uid
k8s.pod.uid
k8s.node.uid
device.id
host.id

Définissez x-instana-host l'en-tête.