Documentation sur Oracle Cloud Infrastructure

Trace et attributs d'intervalle pour l'agent Java APM

Les attributs de trace (intervalle racine) et d'intervalle dans l'explorateur de trace sont définis en marquant un intervalle, qui permet de surveiller efficacement les différents niveaux d'une application.

Les attributs sont des paires clé-valeur attachées à un intervalle pour fournir des informations supplémentaires et un contexte sur l'opération effectuée dans l'intervalle. Une trace comporte des attributs de trace uniquement ainsi que tous les attributs d'intervalle de l'intervalle racine.

Dans l'explorateur de trace, vous pouvez utiliser des attributs pour interroger et filtrer les traces et les intervalles. Il existe deux types d'attribut : Dimensions (attributs de chaîne) et Mesures (attributs numériques) qui sont disponibles dans le panneau Attributs de l'explorateur de trace.

Cette section fournit une liste complète des attributs prêts à l'emploi applicables à l'agent Java APM. Le tableau ci-dessous comprend :

  • Nom : Nom de l'attribut.
  • Description : Brève description de l'attribut.
  • Trace/Span : Disponibilité de l'attribut. Un attribut peut être disponible pour les traces, les intervalles, ou les deux.
  • Type : Type d'attribut : Dimension ou Mesure.
Le nom Description Trace/intervalle Type
ApmVersion Version de l'agent Application Performance Monitoring. Attribut Trace et intervalle Dimension
Appserver Indicateur de détection d'un serveur d'applications. Lorsque le type de serveur d'applications est java-jmx ou java-no-jmx, cette dimension est réglée à false. Attribut Trace et intervalle Dimension
AppserverDisplayPort Numéro de port du serveur d'applications. La valeur par défaut est le port HTTPS le plus bas, s'il est disponible, ou le port HTTP le plus bas. Attribut Trace et intervalle Dimension
AppserverId Code de hachage des ressources importantes du serveur d'applications, qui indique s'il y a une modification de ressource dans le serveur d'applications au fil du temps. Attribut Trace et intervalle Dimension
AppserverName Nom du serveur d'applications. Attribut Trace et intervalle Dimension
AppserverPorts Numéros de port du serveur d'applications. En général, il n'existe qu'un seul numéro de port pour le serveur Oracle WebLogic et plusieurs pour le serveur Apache Tomcat. Dans le cas de numéros de port multiples, les valeurs sont séparées par des virgules. Attribut Trace et intervalle Dimension
AppserverType Type de serveur d'applications. Par exemple : Weblogic ou Tomcat. Attribut Trace et intervalle Dimension
AppserverVersion Version du logiciel du serveur d'applications. Attribut Trace et intervalle Dimension
ClassMethod Nom de classe et de méthode où l'observation d'intervalle s'est produite. Attribut Trace et intervalle Dimension
ClientIp

Adresse IP du client qui a appelé le servlet au moyen de HTTP.

Par défaut, l'agent vérifiera l'en-tête de la demande X-FORWARDED-FOR pour ces informations.

S'il n'est pas disponible, il appellera la méthode ServletRequest.getRemoteAddr.

Le comportement par défaut peut être mis à jour à l'aide du fichier ProbeConfig.acml de l'agent Java APM. (Voir les paramètres capture_client_ip et client_ip_header).

Ces informations sont utilisées pour GeoMap. Selon les adresses IP client saisies, la configuration du mappage géolocalisé peut aider à fournir des résultats plus précis.

Attribut Trace et intervalle Dimension
Component Composant qui a généré l'intervalle à partir de la norme https://opentracing.io/specification/conventions/, avec des valeurs telles que JDBC, SERVLET et BROWSER. Attribut Trace et intervalle Dimension
ContextRoot Racine contextuelle de l'application Web surveillée. Attribut Trace et intervalle Dimension
DbConnUrl URL de connexion JDBC utilisée pour la connexion à la base de données. Attribut Trace et intervalle Dimension
DbOracleConnectionId ID de connexion Net Oracle unique généré par le pilote JDBC Oracle pour chaque connexion JDBC à la base de données Oracle. Cet attribut est pris en charge pour les clients JDBC Oracle 21 et les versions ultérieures. Attribut Trace et intervalle Dimension
DbErrorSqlState Le code SQLState retourné par SQLException.getSQLState dans les scénarios d'erreur. Attribut Trace et intervalle Dimension
DbErrorVendorCode Numéro identifiant l'erreur qui a provoqué le lancement de l'instance SQLException. Attribut Trace et intervalle Mesure
DbOracleSessionId ID session Oracle de l'instruction exécutée. Attribut Trace et intervalle Dimension
DbOracleSqlId ID SQL Oracle calculé à partir de l'instruction SQL exécutée. Attribut Trace et intervalle Dimension
DbOracleSqlId1 Dans les exécutions d'instruction par lots, l'ID SQL Oracle est calculé à partir de la première instruction SQL exécutée. Attribut Trace et intervalle Dimension
DbOracleSqlId2 Dans les exécutions d'instruction par lots, l'ID SQL Oracle est calculé à partir de la deuxième instruction SQL exécutée. Attribut Trace et intervalle Dimension
DbStatement Texte SQL normalisé exécuté par l'instruction JDBC. Attribut Trace et intervalle Dimension
DbStatement1 Dans les exécutions d'instruction batch, le texte SQL normalisé de la première instruction JDBC exécutée. Attribut Trace et intervalle Dimension
DbStatement2 Dans les exécutions d'instruction batch, le texte SQL normalisé de la deuxième instruction JDBC exécutée. Attribut Trace et intervalle Dimension
DbStatementAdditionalFetchCount Nombre d'allers-retours vers la base de données pour extraire des rangées de jeu de résultats supplémentaires non retournées lors de l'exécution de l'énoncé initial. Attribut Trace et intervalle Mesure
DbStatementAdditionalFetchTime Temps (en millisecondes) nécessaire pour extraire des rangées de jeu de résultats supplémentaires de la base de données qui n'ont pas été retournées lors de l'exécution de l'énoncé initial. Attribut Trace et intervalle Mesure
DbStatementExecTime Temps (en millisecondes) passé à l'exécution de l'instruction initiale et à renvoyer les lignes initiales. Attribut Trace et intervalle Mesure
DbType Type de la base de données. Actuellement, seules les bases de données de type SQL sont prises en charge. Attribut Trace et intervalle Dimension
DbUser Utilisateur de la connexion JDBC sous-jacente. Attribut Trace et intervalle Dimension
DeploymentInfo Informations sur le déploiement de l'application Web surveillée. Cela peut être affiché dans deux formats, selon que le type de déploiement est disponible ou non :

<Deployment Name>; <Deployment File Name>

<Deployment Name>; <Deployment File Name>; <Deployment Type>

 Attribut Trace et intervalle Dimension
DisplayName Nom d'affichage du serveur d'applications. Attribut Trace et intervalle Dimension
ECID ID contexte d'exécution Oracle. Attribut d'intervalle Dimension
Error Propriété d'intervalle qui marque un intervalle comme "échec" avec la valeur booléenne true, en cas d'erreur. Cela indique que l'application a considéré que l'opération représentée par l'intervalle a échoué. La valeur booléenne par défaut est false (aucune erreur). Attribut Trace et intervalle Dimension
ErrorObject Description lisible de l'erreur. Attribut Trace et intervalle Dimension
GenAIChatHistory Historique ou contexte des conversations lors d'interactions précédentes avec le modèle d'IA générative Attribut d'intervalle Dimension
GenAICompartmentId Identificateur unique du compartiment dans lequel la demande GenAI est traitée. Attribut d'intervalle Dimension
GenAIEmbeddingsPerSentence Taille de l'intégration vectorielle générée par phrase. Spécifique au modèle utilisé Attribut d'intervalle Dimension
GenAIEmbedResponseId Identificateur unique de la réponse d'intégration Attribut d'intervalle Dimension
GenAIEmbedSentenceCount Nombre de phrases traitées pour la génération d'intégration Attribut d'intervalle Dimension
GenAIEmbedTruncate Stratégie pour tronquer les entrées qui dépassent les limites du modèle (par exemple, NONE, START) Attribut d'intervalle Dimension
GenAIFinishReason Motif pour lequel le modèle a cessé de générer la réponse (par exemple, limite maximale de jeton, séquence d'arrêt) Attribut d'intervalle Dimension
GenAIFrequencyPenalty Pénalise la répétition des mots en fonction de la fréquence d'apparition des mots Attribut d'intervalle Dimension
GenAIInputSentences Les phrases ou fragments de texte réels soumis pour l'intégration Attribut d'intervalle Dimension
GenAIIsEcho Indicateur booléen indiquant si l'invite doit faire l'objet d'un écho dans la réponse Attribut d'intervalle Dimension
GenAIMaxTokens Nombre maximal de jetons que le modèle est autorisé à générer dans sa réponse Attribut d'intervalle Dimension
GenAIModelName Nom du modèle d'intelligence artificielle générative utilisé pour la demande (par exemple, cohere.command) Attribut d'intervalle Dimension
GenAIModelVersion Version spécifique du modèle d'IA générative utilisé Attribut d'intervalle Dimension
GenAINumGenerations Nombre de réponses de remplacement générées pour la même invite Attribut d'intervalle Dimension
GenAIOpcRequestId ID unique pour le suivi de la demande Attribut d'intervalle Dimension
GenAIPresencePenalty Pénalise les mots après la première occurrence, ne tient pas compte de la fréquence d'occurrence Attribut d'intervalle Dimension
GenAIPrompt Invite formatée finale envoyée au modèle, y compris les instructions système, le préambule, l'entrée utilisateur, les documents, les informations sur l'outil, etc. Attribut d'intervalle Dimension
GenAIPromptLength Nombre total de caractères de l'invite complète Attribut d'intervalle Dimension
GenAIQuery Interrogation d'entrée de l'utilisateur envoyée au modèle d'intelligence artificielle générative Attribut d'intervalle Dimension
GenAIQueryLength Nombre de caractères de l'interrogation d'entrée de l'utilisateur Attribut d'intervalle Dimension
GenAIResponse Réponse complète générée par le modèle d'intelligence artificielle générative Attribut d'intervalle Dimension
GenAIResponseLength Nombre de caractères de la réponse du modèle d'intelligence artificielle générative Attribut d'intervalle Dimension
GenAIResponseTimeCreated Horodatage de la génération de la réponse du service d'intelligence artificielle générative Attribut d'intervalle Dimension
GenAISearchQueriesOnly Si la valeur est Vrai, retourne uniquement les interrogations de recherche pertinentes et non les réponses complètes Attribut d'intervalle Dimension
GenAISeed Valeur prédéfinie aléatoire utilisée pour des résultats de génération reproductibles Attribut d'intervalle Dimension
GenAIStatusCode Code de statut HTTP retourné par le point d'extrémité du service d'intelligence artificielle générative Attribut d'intervalle Dimension
GenAIStopSequences Liste des séquences personnalisées spécifiées par l'utilisateur qui déclenchent l'arrêt de la génération de texte par le modèle Attribut d'intervalle Dimension
GenAITemperature Contrôle l'aléatoire dans les mots sélectionnés pour la réponse, la température inférieure est plus déterministe Attribut d'intervalle Dimension
GenAITopK Limite les choix de jetons du modèle aux jetons K les plus probables en fonction de leurs probabilités prédites Attribut d'intervalle Dimension
GenAITopP Le modèle sélectionne son jeton suivant dans l'ensemble des candidats les plus probables dont la probabilité cumulative s'ajoute au seuil des p premiers Attribut d'intervalle Dimension
GenAITotalInputLength Nombre total de caractères de toutes les phrases d'entrée ou fragments de texte combinés pour la génération d'intégration Attribut d'intervalle Dimension
GenAIUserPreamble Instructions personnalisées ou contexte fourni avant l'interrogation principale Attribut d'intervalle Dimension
HostAddress Adresse IPv4 résolue à partir du nom d'hôte. Attribut Trace et intervalle Dimension
Hostname Nom de l'hôte. Attribut Trace et intervalle Dimension
HostnameCanonical Nom canonique (FQDN) de l'hôte. Attribut Trace et intervalle Dimension
HostNames Liste des noms d'hôte dans les interfaces réseau de l'hôte. Attribut Trace et intervalle Dimension
HttpClientType Type de client HTTP surveillé, par exemple Apache HttpClient et HttpURLConnection. Attribut Trace et intervalle Dimension
HttpMethod Méthode HTTP utilisée dans la demande, par exemple GET, POST et DELETE. Attribut Trace et intervalle Dimension
HttpRequestContentSize Longueur du contenu de la demande si Content-Length a été défini dans l'en-tête de la demande. Attribut Trace et intervalle Dimension
HttpResponseContentSize Longueur du contenu de la réponse si Content-Length a été défini dans l'en-tête de la réponse. Attribut Trace et intervalle Dimension
HttpStatusCode Code de statut HTTP de la réponse, par exemple 200, 404 ou 500. Attribut Trace et intervalle Dimension
HttpStatusDetails Description du code de statut de réponse HTTP. Attribut Trace et intervalle Dimension
HttpUrl URL HTTP associée à l'intervalle. Attribut Trace et intervalle Dimension
HttpUrlFragment Fragment d'URL HTTP lié à l'intervalle. Attribut Trace et intervalle Dimension
HttpUrlHost Nom d'hôte de l'URL HTTP associé à l'intervalle. Attribut Trace et intervalle Dimension
HttpUrlPath Chemin de l'URL HTTP associé à l'intervalle. Attribut Trace et intervalle Dimension
HttpUrlQuery Interrogation d'URL HTTP associée à l'intervalle. Attribut Trace et intervalle Dimension
Kind Champ lié à la définition du traçage ouvert (https://opentracing.io/specification/conventions/) span.kind0. L'agent Browser peut signaler des valeurs telles que CLIENT ou INTERNAL, et l'agent Java et d'autres traceurs peuvent signaler des valeurs telles que SERVER pour les servlets et CLIENT pour HttpClient et JDBC. Attribut Trace et intervalle Dimension
NonSampledCount Nombre d'intervalles racine non échantillonnés précédents ayant le même nom d'opération. Attribut Trace et intervalle Mesure
OciAvailabilityDomain Domaine de disponibilité d'Oracle Cloud Infrastructure dans lequel l'instance de calcul s'exécute. Attribut Trace et intervalle Dimension
OciCompartmentId OCID du compartiment dans lequel réside l'instance de calcul. Attribut Trace et intervalle Dimension
NonSampledCount Nombre d'intervalles racine non échantillonnés précédents ayant le même nom d'opération. Attribut Trace et intervalle Mesure
OciAvailabilityDomain Domaine de disponibilité d'Oracle Cloud Infrastructure dans lequel l'instance de calcul s'exécute. Attribut Trace et intervalle Dimension
OciComputeShape Forme de l'instance de calcul. Attribut Trace et intervalle Dimension
OciDisplayName Nom d'affichage de l'instance de calcul ou du noeud Kubernetes. Attribut Trace et intervalle Dimension
OciFaultDomain Nom du domaine d'erreur Oracle Cloud Infrastructure dans lequel l'instance de calcul s'exécute. Attribut Trace et intervalle Dimension
OciInstanceId OCID de l'instance de calcul. Attribut Trace et intervalle Dimension
OciRegion Région Oracle Cloud Infrastructure qui contient le domaine de disponibilité dans lequel l'instance de calcul s'exécute. Attribut Trace et intervalle Dimension
OpcRequestIdRequest Valeur d'en-tête opc-request-id définie dans le cadre de la demande envoyée à Oracle Cloud Infrastructure. Attribut Trace et intervalle Dimension
OpcRequestIdResponse Valeur d'en-tête opc-request-id définie dans le cadre de la réponse envoyée à partir d'Oracle Cloud Infrastructure. Attribut Trace et intervalle Dimension
OperationName Nom de l'intervalle. Attribut Trace et intervalle Dimension
OsAvailableProcessors Nombre de processeurs disponibles pour la JVM (Java Virtual Machine). Attribut Trace et intervalle Mesure
OsFamily Famille du système d'exploitation dérivée de l'agent utilisateur. Par exemple, Linux. Attribut Trace et intervalle Dimension
OsName Nom du système d'exploitation. Attribut Trace et intervalle Dimension
OsVersion Version du système d'exploitation. Attribut Trace et intervalle Dimension
ProcessId ID processus du serveur d'applications. Attribut Trace et intervalle Mesure
RequestPayload Corps des données utiles de la demande saisi dans le cadre de la demande. Les données utiles de la demande peuvent être filtrées pour afficher uniquement des informations utiles à l'aide d'une combinaison de xpath, jsonpath ou regex. Pour plus de détails, consultez le fichier ProbeConfig.acml. Attribut Trace et intervalle Dimension
ResponsePayload Corps des données utiles de la réponse capturé dans le cadre de la réponse. Les données utiles de la réponse peuvent être filtrées pour afficher uniquement des informations utiles à l'aide d'une combinaison de xpath, jsonpath ou regex. Pour plus de détails, consultez le fichier ProbeConfig.acml. Attribut Trace et intervalle Dimension
ServletContainerSpecification Version de la spécification de servlet sur laquelle l'application représentée par cette ServletContext est basée.

Attribut Trace et intervalle Dimension
ServletSpecification Version de l'API de servlet prise en charge par ce conteneur de servlets. Attribut Trace et intervalle Dimension
ServiceInstanceId ID observateur de l'agent. Attribut Trace et intervalle Dimension
ServiceName Nom que vous avez affecté au service. Attribut Trace et intervalle Dimension
SessionId Identificateur unique de la session ou du navigateur. Attribut Trace et intervalle Dimension
SoaTaskAssigneeUsers Liste des noms d'utilisateur des utilisateurs auxquels cette tâche a été affectée.

Pour voir cette dimension, vous devez définir capture_username=true dans le fichier ProbeConfig.acml.

Cet attribut est présent lors de l'utilisation d'Oracle SOA Human Workflow.

 Attribut d'intervalle Dimension
SoaTaskCompletionDuration Durée en millisecondes entre le moment où la tâche est lancée et le moment où elle est terminée.

Cet attribut est présent lors de l'utilisation d'Oracle SOA Human Workflow.

 Attribut d'intervalle Dimension
SoaTaskName Nom de la tâche.

Cet attribut est présent lors de l'utilisation d'Oracle SOA Human Workflow.

 Attribut d'intervalle Dimension
SoaTaskNumber Numéro de tâche affiché dans la colonne Number de la liste de travail BPM.

Cet attribut est présent lors de l'utilisation d'Oracle SOA Human Workflow.

 Attribut d'intervalle Dimension
SoaTaskOutcome Résultat de la tâche une fois terminée.

Cet attribut est présent lors de l'utilisation d'Oracle SOA Human Workflow.

 Attribut d'intervalle Dimension
SoaTaskRequester Nom d'utilisateur du demandeur de la tâche.

Pour voir cette dimension, vous devez définir capture_username=true dans le fichier ProbeConfig.acml.

Cet attribut est présent lors de l'utilisation d'Oracle SOA Human Workflow.

 Attribut d'intervalle Dimension
SoaTaskState État de la tâche.

Cet attribut est présent lors de l'utilisation d'Oracle SOA Human Workflow.

 Attribut d'intervalle Dimension
SoaTaskSubstate Sous-état de la tâche, le cas échéant.

Cet attribut est présent lors de l'utilisation d'Oracle SOA Human Workflow.

 Attribut d'intervalle Dimension
SoaWorkflowNumber Numéro du flux de travail.

Cet attribut est présent lors de l'utilisation d'Oracle SOA Human Workflow.

 Attribut d'intervalle Dimension
SpanID Identificateur unique de chaque intervalle. Attribut d'intervalle Dimension
StartTime Heure de début de l'intervalle. Attribut d'intervalle Mesure
Subcomponent Sous-composant qui a généré l'intervalle. Attribut d'intervalle Dimension
ThreadAllocatedMemory Approximation de la quantité totale de mémoire en octets allouée dans la mémoire en tas pour l'intervalle de servlets associé. Ces informations sont obtenues à l'adresse ThreadMXBean et saisies par défaut.

Le comportement par défaut peut être désactivé à l'aide du fichier ProbeConfig.acml de l'agent Java APM. (Voir le paramètre tag_thread_allocated_memory).

Attribut d'intervalle Dimension
ThreadCpuTime Temps UC total en millisecondes pour le servlet associé. Ces informations sont obtenues à l'adresse ThreadMXBean et saisies par défaut.

Le comportement par défaut peut être désactivé à l'aide du fichier ProbeConfig.acml de l'agent Java APM. (Voir le paramètre tag_thread_cpu_time).

Attribut d'intervalle Dimension
ThreadId ID de l'unité d'exécution où l'intervalle a commencé. Attribut d'intervalle Mesure
ThreadIdEnd ID du fil où l'intervalle s'est terminé. Attribut d'intervalle Mesure
ThreadName Nom du fil où l'intervalle a commencé. Attribut d'intervalle Dimension
ThreadNameEnd Nom du fil où l'intervalle s'est terminé. Attribut d'intervalle Dimension
UserName Nom d'utilisateur de l'utilisateur final qui utilise le système ou identificateur identifiant de manière unique l'utilisateur.

Pour plus d'informations sur les options de saisie et de configuration du nom d'utilisateur, voir Modifier ou désactiver les paramètres de sonde par défaut.

Attribut Trace et intervalle Dimension
VmName Nom de la machine virtuelle. Attribut Trace et intervalle Dimension
VmVendor Fournisseur de la machine virtuelle. Attribut Trace et intervalle Dimension
VmVersion Version de la machine virtuelle. Attribut Trace et intervalle Dimension
WorkingDirectory Répertoire de travail du serveur d'applications. Attribut Trace et intervalle Dimension