Documentation sur Oracle Cloud Infrastructure

Définir la dimension de ressource

Une fois l'agent Java APM déployé, vous pouvez définir la dimension des ressources de 2 manières différentes :

Définition de ressource simplifiée

La dimension de ressources simplifiée peut être définie avec des propriétés de paire clé-valeur.

La clé de la propriété doit commencer par com.oracle.apm.agent.resource.tag.

Le tableau suivant présente différentes façons de définir la dimension des ressources de la manière simplifiée :

Type et description des propriétés Pris en charge par Propriété Exemple

AgentConfig.properties

Mettre à jour le fichier AgentConfig.properties situé dans le répertoire oracle-apm-agent/config/<version>.

Agent APM com.oracle.apm.agent.resource.tag.<ResourceName> com.oracle.apm.agent.resource.tag.MyDepartment=Sales

Propriétés de système

Mettre à jour les propriétés du système.

 Agent APM et traceur APM com.oracle.apm.agent.resource.tag.<ResourceName>

-Dcom.oracle.apm.agent.resource.tag.MyDepartment=Sales

-Dcom.oracle.apm.agent.resource.tag.MyUser=${USERNAME}

-Dcom.oracle.apm.agent.resource.tag.MyAppVersion=${com.mycompany.myapp.version}

Variables d'environnement

Mettre à jour les variables d'environnement.

 Agent APM et traceur APM com_oracle_apm_agent_resource.tag_<ResourceName>
Pour Windows : 
set com_oracle_apm_agent_resource_tag_MyDepartment=Sales
set com.oracle.apm.agent.resource.tag.MyUser=${USERNAME}
Pour Linux : 
export com_oracle_apm_agent_resource_tag_MyDepartment=Sales

Trace Builder

 Traceur APM com.oracle.apm.agent.resource.tag.<ResourceName> 
new ApmTracer.Builder(...)
    ...
    .withProperty("com.oracle.apm.agent.resource.tag.MyDepartment", "Sales")
    .withProperty("com.oracle.apm.agent.resource.tag.MyUser", "${USERNAME}")
    ...
    .build();

La valeur de la propriété de ressource peut être un texte statique et/ou une variable encadrée par les symboles ${ et }.

Une ou plusieurs des valeurs suivantes sont acceptées en tant que valeur de dimension de ressource :
  • Tout texte.
  • Clé des propriétés du système Java encadrées par les symboles ${ et }.
  • Clé des variables d'environnement encadrées par les symboles ${ et }. Par exemple :
    ${USERNAME}

Définition complète des ressources

Vous pouvez définir une dimension de ressource de serveur d'applications personnalisée pour répondre à des besoins spécifiques.

Pour définir une dimension de ressource de serveur d'applications personnalisée, créez un fichier de configuration nommé ResourceCollection.acml dans le répertoire oracle-apm-agent/config/<version>.

Le fichier ResourceCollection.acml n'est pas créé par le déploiement de l'agent APM et il doit être créé manuellement.

Le format ResourceCollection.acml est un format ACML personnalisé (sous-ensemble de YAML).

Balise ACML Type de données Obligatoire Description
RESOURCE :   oui En-tête de collecte de ressources.
<resource_entry_name> : chaîne oui Nom de la ressource de production de rapports.
property: <property key> chaîne oui Clé de propriété APM de la ressource.

Il s'agit de la clé de propriété de cette valeur de ressource. Elle est également utilisée par d'autres ressources pour la résolution de variables.

type: <resource type> chaîne oui Type de cette propriété.
scalar: <resource scalar> chaîne oui Type de valeur de ressource.

Les valeurs prises en charge sont string, long ou double.
identity: <resource as identity> booléen Non L'indicateur indique si cette ressource est utilisée pour le calcul de l'identité du serveur d'applications.

Toute ressource avec une valeur non nulle est utilisée pour le calcul de la dimension appserverId.

priority: <collection priority> entier non signé Non Nombre entier positif pour indiquer la priorité de collecte des ressources. 0 (zéro) est la priorité la plus élevée. La ressource personnalisée doit toujours régler cette valeur à 0.
default: <default value> chaîne Non Valeur par défaut de la ressource lorsqu'aucune des sources spécifiées ne retourne une valeur non nulle.
source: Sans objet oui Noeud de tableau des sources de cette ressource.

Un ou plusieurs éléments enfants peuvent être définis pour ce tableau source. Chaque élément est évalué dans l'ordre défini et le premier avec une valeur non nulle est utilisé.

Si aucune valeur non nulle n'a été retournée pour l'évaluation de l'élément, cette ressource est ignorée.
- type : mbean chaîne Non Collectez les métadonnées de ressource à partir du composant MBean JMX. Plusieurs peuvent être définis pour chaque ressource.
mbean_name: <mbean object name> chaîne Non mbean_name est le ObjectName du MBean.
value_path : <value selection path> chaîne Non

value_path est le chemin de sélection délimité par une barre oblique à partir du MBean spécifié.

Le premier noeud de chemin est l'attribut du MBean, puis la valeur de l'attribut est évaluée avec chaque noeud de chemin successif.

L'évaluation prend en charge les éléments suivants :

  • Attribut MBean
  • ObjectName
  • Nom de champ d'objet Java
  • java object no-arg method name
  • Clé de CompositeData
  • Clé de TubularData
  • Index du tableau
  • Clé de mappage
  • Index de la collecte
<regex parsing> chaîne Non

La valeur de ressource sélectionnée peut être traitée plus en utilisant des balises d'analyse d'expression rationnelle. Voir Analyse de l'expression rationnelle pour plus d'informations.

type : propriété chaîne Non Valeur de ressource de la propriété de système ou de la variable d'environnement. Plusieurs peuvent être définis pour chaque ressource.
key: <property key> chaîne Non Nom de la propriété système ou de la variable d'environnement.
- type : valeur chaîne Non La valeur statique. Au plus une ressource doit être définie, car cette valeur n'est jamais nulle.
value: <static value and/or variable> chaîne Non La valeur peut être une ou plusieurs des valeurs suivantes :
  • Chaîne fixe.
  • Propriété de système.
  • Variable d'environnement.
  • Propriété de la ressource.

Les clés de propriétés contiennent les symboles ${ et } qui seront résolus lors de l'exécution en une valeur de clé spécifiée. Si la clé de propriété spécifiée est introuvable, la valeur de cette ressource contiendra la clé non résolue, y compris les symboles ${ et }.

<regex parsing> chaîne Non La valeur de ressource sélectionnée peut être traitée plus en utilisant des balises d'analyse d'expression rationnelle. Voir Analyse de l'expression rationnelle pour plus d'informations.

Analyse de l'expression rationnelle

L'analyse des expressions rationnelles est des marqueurs supplémentaires du noeud source pour extraire une valeur spécifique de la valeur de la ressource avec une expression rationnelle. Pour plus de détails sur la syntaxe, voir ci-dessous :

Étiquette Type de base Description
regex : <regex : : chaîne Expression rationnelle par rapport à la valeur des ressources avec la construction de groupe.
<regex parsing> entier non signé Nombre de groupes d'expressions rationnelles. La valeur du groupe spécifié est la valeur finale de la ressource.