Documentation Oracle Cloud Infrastructure

Attributs de trace et d'étendue pour l'agent Java APM

Les attributs de trace (étendue racine) et d'étendue de l'explorateur de traces sont définis par le balisage d'une étendue qui permet de surveiller efficacement les différents niveaux d'une application.

Les attributs sont des paires clé-valeur associées à l'étendue pour fournir des informations et le contexte supplémentaires sur l'opération effectuée dans cette dernière. Une trace possède des attributs de trace uniquement ainsi que tous les attributs d'étendue de l'étendue racine.

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

Cette section fournit la 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/étendue : disponibilité de l'attribut. Un attribut peut être disponible pour les traces, les étendues ou les deux.
  • Type : type d'attribut : dimension ou mesure.
Nom Description Trace/étendue Type
ApmVersion Version de l'agent Application Performance Monitoring. Attribut de trace et d'étendue Dimension
Appserver Indicateur permettant de signaler si un serveur d'applications a été repéré. Si le type de serveur d'applications est java-jmx ou java-no-jmx, cette dimension est définie sur false. Attribut de trace et d'étendue Dimension
AppserverDisplayPort Numéro de port du serveur d'applications. La valeur par défaut correspond au port HTTPS le plus bas, s'il est disponible, ou au port HTTP le plus bas. Attribut de trace et d'étendue Dimension
AppserverId Hachage des ressources importantes du serveur d'applications permettant d'indiquer si le serveur d'applications a changé au fil du temps. Attribut de trace et d'étendue Dimension
AppserverName Nom du système d'applications. Attribut de trace et d'étendue 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 plusieurs numéros de port, les valeurs sont séparées par des virgules. Attribut de trace et d'étendue Dimension
AppserverType Type de serveur d'applications. Par exemple : Weblogic ou Tomcat. Attribut de trace et d'étendue Dimension
AppserverVersion Version du logiciel du serveur d'applications. Attribut de trace et d'étendue Dimension
ClassMethod Nom de la classe et nom de la méthode où l'observation de l'étendue s'est produite. Attribut de trace et d'étendue Dimension
ClientIp

Adresse IP du client qui a appelé le servlet via HTTP.

Par défaut, l'agent recherche ces informations dans l'en-tête de demande X-FORWARDED-FOR.

Si elle n'est pas disponible, elle appelle la méthode ServletRequest.getRemoteAddr.

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

Ces informations sont utilisées pour le fichier GeoMap. En fonction des adresses IP client capturées, la configuration de la mise en correspondance Geo IP peut vous aider à obtenir des résultats plus précis.

Attribut de trace et d'étendue Dimension
Component Composant qui a généré la portée à partir de la norme https://opentracing.io/specification/conventions/, avec des valeurs telles que JDBC, SERVLET et BROWSER. Attribut de trace et d'étendue Dimension
ContextRoot Racine de contexte de l'application Web surveillée. Attribut de trace et d'étendue Dimension
DbConnUrl URL de connexion JDBC utilisée pour la connexion à la base de données. Attribut de trace et d'étendue 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 sur les clients JDBC Oracle 21 et versions ultérieures. Attribut de trace et d'étendue Dimension
DbErrorSqlState Code SQLState renvoyé par SQLException.getSQLState dans les scénarios d'erreur. Attribut de trace et d'étendue Dimension
DbErrorVendorCode Numéro identifiant l'erreur qui a entraîné la génération de l'instance SQLException. Attribut de trace et d'étendue Mesure
DbOracleSessionId ID de session Oracle de l'instruction exécutée. Attribut de trace et d'étendue Dimension
DbOracleSqlId ID SQL Oracle calculé à partir de l'instruction SQL exécutée. Attribut de trace et d'étendue Dimension
DbOracleSqlId1 Dans les exécutions d'instructions par lots, l'ID SQL Oracle est calculé à partir de la première instruction SQL exécutée. Attribut de trace et d'étendue Dimension
DbOracleSqlId2 Dans les exécutions d'instructions par lots, l'ID SQL Oracle est calculé à partir de la deuxième instruction SQL exécutée. Attribut de trace et d'étendue Dimension
DbStatement Texte SQL normalisé exécuté par l'instruction JDBC. Attribut de trace et d'étendue Dimension
DbStatement1 Dans les exécutions d'instructions par lots, le texte SQL normalisé de la première instruction JDBC exécutée. Attribut de trace et d'étendue Dimension
DbStatement2 Dans les exécutions d'instructions par lots, le texte SQL normalisé de la deuxième instruction JDBC exécutée. Attribut de trace et d'étendue Dimension
DbStatementAdditionalFetchCount Nombre d'allers-retours vers la base de données pour extraire des lignes d'ensemble de résultats supplémentaires non renvoyées lors de l'exécution initiale de l'instruction. Attribut de trace et d'étendue Mesure
DbStatementAdditionalFetchTime Temps (en millisecondes) passé à extraire des lignes d'ensemble de résultats supplémentaires de la base de données qui n'ont pas été renvoyées lors de l'exécution initiale de l'instruction. Attribut de trace et d'étendue Mesure
DbStatementExecTime Temps (en millisecondes) consacré à l'exécution initiale de l'instruction et au renvoi des lignes initiales. Attribut de trace et d'étendue Mesure
DbType Type de la base de données. Actuellement, seules les bases de données de type "sql" sont prises en charge. Attribut de trace et d'étendue Dimension
DbUser Utilisateur de connexion JDBC sous-jacent. Attribut de trace et d'étendue Dimension
DeploymentInfo Informations de déploiement relatives à l'application Web surveillée. Elle peut s'afficher 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 de trace et d'étendue Dimension
DisplayName Nom d'affichage du serveur d'applications. Attribut de trace et d'étendue Dimension
ECID ID contexte d'exécution Oracle. Attribut d'étendue Dimension
Error Propriété d'étendue qui marque une étendue 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'étendue a échoué. La valeur booléenne par défaut est false (aucune erreur). Attribut de trace et d'étendue Dimension
ErrorObject Description lisible par l'utilisateur de l'erreur. Attribut de trace et d'étendue Dimension
GenAIChatHistory Historique ou contexte des interactions précédentes avec le modèle d'IA générative Attribut d'étendue Dimension
GenAICompartmentId Identificateur unique du compartiment dans lequel la demande GenAI est traitée. Attribut d'étendue Dimension
GenAIEmbeddingsPerSentence Taille de l'intégration vectorielle générée par phrase. Spécifique au modèle utilisé Attribut d'étendue Dimension
GenAIEmbedResponseId Identifiant unique de la réponse d'intégration Attribut d'étendue Dimension
GenAIEmbedSentenceCount Nombre de phrases traitées pour la génération d'intégration Attribut d'étendue Dimension
GenAIEmbedTruncate Stratégie visant à tronquer les entrées dépassant les limites du modèle (par exemple, NONE, START) Attribut d'étendue Dimension
GenAIFinishReason La raison pour laquelle le modèle a arrêté de générer la réponse (par exemple, limite maximale de jeton, séquence d'arrêt) Attribut d'étendue Dimension
GenAIFrequencyPenalty Pénalise la répétition des mots en fonction de la fréquence d'occurrence des mots Attribut d'étendue Dimension
GenAIInputSentences Les phrases ou blocs de texte réels soumis pour intégration Attribut d'étendue Dimension
GenAIIsEcho Indicateur booléen indiquant si l'invite doit être renvoyée dans la réponse Attribut d'étendue Dimension
GenAIMaxTokens Nombre maximal de jetons que le modèle est autorisé à générer dans sa réponse Attribut d'étendue Dimension
GenAIModelName Nom du modèle d'IA générative utilisé pour la demande (par exemple, cohere.command) Attribut d'étendue Dimension
GenAIModelVersion Version spécifique du modèle d'IA générative utilisé Attribut d'étendue Dimension
GenAINumGenerations Nombre de réponses alternatives générées pour la même invite Attribut d'étendue Dimension
GenAIOpcRequestId ID unique pour le suivi de la demande Attribut d'étendue Dimension
GenAIPresencePenalty Pénalise les mots après la première occurrence, ne prend pas en compte la fréquence d'occurrence Attribut d'étendue Dimension
GenAIPrompt L'invite formatée finale envoyée au modèle, y compris les instructions système, le préambule, la saisie utilisateur, les documents, les informations sur l'outil, etc. Attribut d'étendue Dimension
GenAIPromptLength Nombre total de caractères de l'invite complète Attribut d'étendue Dimension
GenAIQuery Requête d'entrée de l'utilisateur envoyée au modèle d'IA générative Attribut d'étendue Dimension
GenAIQueryLength Nombre de caractères de la requête d'entrée de l'utilisateur Attribut d'étendue Dimension
GenAIResponse Réponse complète générée par le modèle d'IA générative Attribut d'étendue Dimension
GenAIResponseLength Nombre de caractères de la réponse du modèle d'IA générative Attribut d'étendue Dimension
GenAIResponseTimeCreated Horodatage de la génération de la réponse d'IA générative Attribut d'étendue Dimension
GenAISearchQueriesOnly Si la valeur est True, renvoie uniquement les requêtes de recherche pertinentes, pas les réponses complètes Attribut d'étendue Dimension
GenAISeed Valeur de départ aléatoire utilisée pour les résultats de génération reproductibles Attribut d'étendue Dimension
GenAIStatusCode Code de statut HTTP renvoyé par l'adresse d'IA générative Attribut d'étendue 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'étendue Dimension
GenAITemperature Contrôle le caractère aléatoire des mots sélectionnés pour la réponse, une température plus basse est plus déterministe Attribut d'étendue Dimension
GenAITopK Limite les choix de jetons du modèle aux K jetons les plus probables en fonction de leurs probabilités prédites Attribut d'étendue Dimension
GenAITopP Le modèle sélectionne son jeton suivant dans l'ensemble des candidats les plus probables dont la probabilité cumulée s'ajoute au seuil supérieur-p Attribut d'étendue Dimension
GenAITotalInputLength Nombre total de caractères de toutes les phrases d'entrée ou de tous les blocs de texte combinés pour la génération d'intégration Attribut d'étendue Dimension
GenAIUserPreamble Instructions ou contexte personnalisés fournis avant la requête principale Attribut d'étendue Dimension
HostAddress L'adresse IPv4 résolue à partir du nom d'hôte. Attribut de trace et d'étendue Dimension
Hostname Nom de l'hôte. Attribut de trace et d'étendue Dimension
HostnameCanonical Nom canonique (nom de domaine qualifié complet) de l'hôte. Attribut de trace et d'étendue Dimension
HostNames Liste des noms d'hôte dans les interfaces réseau de l'hôte. Attribut de trace et d'étendue Dimension
HttpClientType Type de client HTTP surveillé, par exemple, Apache HttpClient et HttpURLConnection. Attribut de trace et d'étendue Dimension
HttpMethod Méthode HTTP utilisée dans la demande, par exemple, GET, POST et DELETE. Attribut de trace et d'étendue Dimension
HttpRequestContentSize Longueur de contenu de la demande si Content-Length a été défini dans l'en-tête de la demande. Attribut de trace et d'étendue Dimension
HttpResponseContentSize Longueur de contenu de la réponse si Content-Length a été défini comme faisant partie de l'en-tête de réponse. Attribut de trace et d'étendue Dimension
HttpStatusCode Code de statut HTTP de la réponse, par exemple, 200, 404 ou 500. Attribut de trace et d'étendue Dimension
HttpStatusDetails Description du code de statut de réponse HTTP. Attribut de trace et d'étendue Dimension
HttpUrl URL HTTP associée à l'étendue. Attribut de trace et d'étendue Dimension
HttpUrlFragment Fragment d'URL HTTP lié à l'étendue. Attribut de trace et d'étendue Dimension
HttpUrlHost Nom d'hôte de l'URL HTTP lié à l'étendue. Attribut de trace et d'étendue Dimension
HttpUrlPath Chemin d'URL HTTP associé à l'étendue. Attribut de trace et d'étendue Dimension
HttpUrlQuery Requête d'URL HTTP associée à l'étendue. Attribut de trace et d'étendue Dimension
Kind Champ relatif à la définition de trace ouverte (https://opentracing.io/specification/conventions/) span.kind0. L'agent de navigateur 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 de trace et d'étendue Dimension
NonSampledCount Nombre d'étendues racine non échantillonnées précédentes ayant le même nom d'opération. Attribut de trace et d'étendue Mesure
OciAvailabilityDomain Domaine de disponibilité Oracle Cloud Infrastructure dans lequel l'instance de calcul est exécutée. Attribut de trace et d'étendue Dimension
OciCompartmentId OCID du compartiment dans lequel réside l'instance de calcul. Attribut de trace et d'étendue Dimension
NonSampledCount Nombre d'étendues racine non échantillonnées précédentes ayant le même nom d'opération. Attribut de trace et d'étendue Mesure
OciAvailabilityDomain Domaine de disponibilité Oracle Cloud Infrastructure dans lequel l'instance de calcul est exécutée. Attribut de trace et d'étendue Dimension
OciComputeShape Forme de l'instance de calcul. Attribut de trace et d'étendue Dimension
OciDisplayName Nom d'affichage du noeud Kubernetes ou de l'instance de calcul. Attribut de trace et d'étendue Dimension
OciFaultDomain Nom du domaine d'erreur Oracle Cloud Infrastructure dans lequel l'instance de calcul est exécutée. Attribut de trace et d'étendue Dimension
OciInstanceId OCID de l'instance de calcul. Attribut de trace et d'étendue Dimension
OciRegion Région Oracle Cloud Infrastructure contenant le domaine de disponibilité dans lequel l'instance de calcul est exécutée. Attribut de trace et d'étendue Dimension
OpcRequestIdRequest Valeur d'en-tête opc-request-id définie dans le cadre de la demande envoyée à Oracle Cloud Infrastructure. Attribut de trace et d'étendue 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 de trace et d'étendue Dimension
OperationName Nom de l'étendue. Attribut de trace et d'étendue Dimension
OsAvailableProcessors Nombre de processeurs disponibles pour la Java Virtual Machine (JVM). Attribut de trace et d'étendue Mesure
OsFamily Famille de systèmes d'exploitation dérivée de l'agent utilisateur. Par exemple, Linux. Attribut de trace et d'étendue Dimension
OsName Nom du système d'exploitation. Attribut de trace et d'étendue Dimension
OsVersion La version du système d'exploitation. Attribut de trace et d'étendue Dimension
ProcessId ID de processus du serveur d'applications. Attribut de trace et d'étendue Mesure
RequestPayload Corps de charge utile de demande capturé dans le cadre de la demande. La charge utile de la demande peut être filtrée pour n'afficher que des informations utiles à l'aide d'une combinaison de XPath, jsonpath ou expression régulière. Pour plus d'informations, consultez le fichier ProbeConfig.acml. Attribut de trace et d'étendue Dimension
ResponsePayload Corps de charge utile de réponse capturé dans le cadre de la réponse. La charge utile de réponse peut être filtrée pour afficher uniquement des informations utiles à l'aide d'une combinaison de XPath, jsonpath ou expression régulière. Pour plus d'informations, consultez le fichier ProbeConfig.acml. Attribut de trace et d'étendue Dimension
ServletContainerSpecification Version de la spécification de servlet sur laquelle repose l'application représentée par ce ServletContext.

Attribut de trace et d'étendue Dimension
ServletSpecification Version de l'API de servlet prise en charge par ce conteneur de servlet. Attribut de trace et d'étendue Dimension
ServiceInstanceId ID d'observateur de l'agent. Attribut de trace et d'étendue Dimension
ServiceName Nom que vous avez affecté au service. Attribut de trace et d'étendue Dimension
SessionId Identificateur unique de la session ou du navigateur. Attribut de trace et d'étendue 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 du workflow humain Oracle SOA.

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

Cet attribut est présent lors de l'utilisation du workflow humain Oracle SOA.

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

Cet attribut est présent lors de l'utilisation du workflow humain Oracle SOA.

 Attribut d'étendue Dimension
SoaTaskNumber Numéro de tâche affiché dans la colonne Number de BPM Worklist.

Cet attribut est présent lors de l'utilisation du workflow humain Oracle SOA.

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

Cet attribut est présent lors de l'utilisation du workflow humain Oracle SOA.

 Attribut d'étendue 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 du workflow humain Oracle SOA.

 Attribut d'étendue Dimension
SoaTaskState Etat de la tâche.

Cet attribut est présent lors de l'utilisation du workflow humain Oracle SOA.

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

Cet attribut est présent lors de l'utilisation du workflow humain Oracle SOA.

 Attribut d'étendue Dimension
SoaWorkflowNumber Numéro de workflow.

Cet attribut est présent lors de l'utilisation du workflow humain Oracle SOA.

 Attribut d'étendue Dimension
SpanID Identificateur unique de chaque étendue. Attribut d'étendue Dimension
StartTime Heure de début de la plage. Attribut d'étendue Mesure
Subcomponent Sous-composant qui a généré l'étendue. Attribut d'étendue Dimension
ThreadAllocatedMemory Approximation de la quantité totale de mémoire en octets allouée dans la portion de mémoire pour l'étendue de servlet associée. Ces informations sont obtenues à partir de ThreadMXBean et capturées 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'étendue Dimension
ThreadCpuTime Temps UC total pour l'étendue de servlet associée, en millisecondes. Ces informations sont obtenues à partir de ThreadMXBean et capturées 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'étendue Dimension
ThreadId ID du thread où l'étendue a commencé. Attribut d'étendue Mesure
ThreadIdEnd ID du thread où l'étendue s'est terminée. Attribut d'étendue Mesure
ThreadName Nom du thread où l'étendue a commencé. Attribut d'étendue Dimension
ThreadNameEnd Nom du thread où l'étendue s'est terminée. Attribut d'étendue Dimension
UserName Nom d'utilisateur de l'utilisateur final utilisant le système ou identifiant qui identifie l'utilisateur de manière unique.

Pour plus d'informations sur les options de capture et de configuration de nom utilisateur, reportez-vous à la section Modify or Disable Default Probe Settings.

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