Objet de métrique APM

Les objets suivants sont directement liés à l'API apmmetric.

Chaque propriété, à l'exception de type, correspond à une colonne des tables de métriques (otel_metrics_gauge, otel_metrics_sum, otel_metrics_histogram et otel_metrics_exponential_histogram) de la source de données de télémétrie. La plupart des propriétés correspondent à la colonne portant le même nom (par exemple, la propriété metric_name correspond à la colonne MetricName). Lorsque les noms diffèrent, les colonnes de la source de données sont indiquées dans les tableaux ci-dessous. Pour obtenir la liste des colonnes, consultez Colonnes de données de télémétrie prises en charge.

Métrique APM

L’objet de métrique APM représente un point de données d’une métrique (la valeur, ou les valeurs agrégées, d’une mesure à un moment donné).

L’objet de métrique APM possède les propriétés suivantes :

Property Type Description
type integer Type du point de données.

Valeurs possibles :
0 - Jauge ;
1 - Somme ;
2 - Histogramme ;
3 - Histogramme exponentiel.

Le type est déterminé par la table qui contient le point de données : otel_metrics_gauge, otel_metrics_sum, otel_metrics_histogram ou otel_metrics_exponential_histogram.

Comportement de la propriété :
- lecture seule
resource_attributes object Attributs de ressource clé-valeur du point de données (par exemple, host.name: eabf8c2a5ddc).

Comportement de la propriété :
- lecture seule
resource_schema_url string URL, le cas échéant, du schéma OpenTelemetry des attributs de la ressource.

Comportement de la propriété :
- lecture seule
scope_name string Nom du périmètre d’instrumentation ayant produit le point de données.

Comportement de la propriété :
- lecture seule
scope_version string Version, le cas échéant, du périmètre d’instrumentation.

Comportement de la propriété :
- lecture seule
scope_attributes object Attributs clé-valeur du périmètre d’instrumentation.

Comportement de la propriété :
- lecture seule
scope_schema_url string URL, le cas échéant, du schéma OpenTelemetry du périmètre d’instrumentation et de ses attributs.

Comportement de la propriété :
- lecture seule
service_name string Nom du service ayant produit le point de données (par exemple, zabbix-frontend), extrait de l’attribut de ressource OpenTelemetry service.name.

Comportement de la propriété :
- lecture seule
metric_name string Nom de la métrique à laquelle appartient le point de données (par exemple, http.server.request.duration).

Comportement de la propriété :
- lecture seule
metric_description string Description, le cas échéant, de la métrique.

Comportement de la propriété :
- lecture seule
metric_unit string Unité, le cas échéant, des valeurs de la métrique (par exemple, s ou By ; voir UCUM).

Comportement de la propriété :
- lecture seule
attributes object Attributs du point de données clé-valeur (par exemple, http.request.method: POST).

Comportement de la propriété :
- lecture seule
start_time_unix integer Heure Unix (en nanosecondes) à laquelle a commencé la période de mesure du point de données.

Comportement de la propriété :
- lecture seule
time_unix integer Heure Unix (en nanosecondes) du point de données.
Pour les points de données de type Somme, Histogramme et Histogramme exponentiel, il s’agit de la fin de la période de mesure.

Comportement de la propriété :
- lecture seule
value float Valeur du point de données.
S’applique aux points de données de type Jauge et Somme.

Valeur par défaut : 0.

Comportement de la propriété :
- lecture seule
flags integer Masque de bits des indicateurs du point de données.
Si le bit de poids faible est défini (valeur 1), aucune valeur n’a été enregistrée pour le point de données.

Comportement de la propriété :
- lecture seule
exemplars array Tableau d’objets exemplaire, c’est-à-dire de mesures individuelles conservées comme exemples, avec la trace et le span pendant lesquels elles ont été enregistrées.

Comportement de la propriété :
- lecture seule
aggregation_temporality integer Manière dont les valeurs du point de données sont agrégées au fil du temps.
S’applique aux points de données de type Somme, Histogramme et Histogramme exponentiel.

Valeurs possibles :
0 - (par défaut) Non spécifiée ;
1 - Delta (agrégée sur la période depuis le point de données précédent) ;
2 - Cumulative (agrégée sur la période depuis start_time_unix).

Comportement de la propriété :
- lecture seule
is_monotonic boolean Indique si la somme peut uniquement augmenter ou rester constante au fil du temps.
S’applique aux points de données de type Somme.

Valeur par défaut : false.

Comportement de la propriété :
- lecture seule
count integer Nombre de mesures dans le point de données.
S’applique aux points de données de type Histogramme et Histogramme exponentiel.

Valeur par défaut : 0.

Comportement de la propriété :
- lecture seule
sum float Somme de toutes les mesures du point de données.
S’applique aux points de données de type Histogramme et Histogramme exponentiel.

Valeur par défaut : 0.

Comportement de la propriété :
- lecture seule
bucket_counts array Tableau d’entiers indiquant le nombre de mesures dans chaque compartiment de l’histogramme.
Les compartiments sont définis par explicit_bounds.
S’applique aux points de données de type Histogramme.

Valeur par défaut : [].

Comportement de la propriété :
- lecture seule
explicit_bounds array Tableau de nombres flottants indiquant les limites entre les compartiments de l’histogramme.
S’applique aux points de données de type Histogramme.

Valeur par défaut : [].

Comportement de la propriété :
- lecture seule
min float Plus petite des mesures du point de données.
S’applique aux points de données de type Histogramme et Histogramme exponentiel.

Valeur par défaut : 0.

Comportement de la propriété :
- lecture seule
max float Plus grande des mesures du point de données.
S’applique aux points de données de type Histogramme et Histogramme exponentiel.

Valeur par défaut : 0.

Comportement de la propriété :
- lecture seule
scale integer Échelle de l’histogramme exponentiel, qui détermine les limites et la résolution des compartiments.
Une échelle plus élevée produit des compartiments plus étroits et une résolution plus fine ; une échelle plus faible produit des compartiments plus larges et une résolution plus grossière.
S’applique aux points de données de type Histogramme exponentiel.

Valeur par défaut : 0.

Comportement de la propriété :
- lecture seule
zero_count integer Nombre de mesures dans le compartiment zéro de l’histogramme exponentiel.
S’applique aux points de données de type Histogramme exponentiel.

Valeur par défaut : 0.

Comportement de la propriété :
- lecture seule
positive_bucket_counts array Tableau d’entiers indiquant le nombre de mesures positives dans chaque compartiment de l’histogramme exponentiel.
Les limites des compartiments sont déterminées par scale ; l’index du premier compartiment est défini dans positive_offset.
S’applique aux points de données de type Histogramme exponentiel.

Valeur par défaut : [].

Comportement de la propriété :
- lecture seule
positive_offset integer Index du premier compartiment dans positive_bucket_counts.
S’applique aux points de données de type Histogramme exponentiel.

Valeur par défaut : 0.

Comportement de la propriété :
- lecture seule
negative_bucket_counts array Tableau d’entiers indiquant le nombre de mesures négatives dans chaque compartiment de l’histogramme exponentiel.
Les limites des compartiments sont déterminées par scale ; l’index du premier compartiment est défini dans negative_offset.
S’applique aux points de données de type Histogramme exponentiel.

Valeur par défaut : [].

Comportement de la propriété :
- lecture seule
negative_offset integer Index du premier compartiment dans negative_bucket_counts.
S’applique aux points de données de type Histogramme exponentiel.

Valeur par défaut : 0.

Comportement de la propriété :
- lecture seule

Exemple

L’objet exemple possède les propriétés suivantes :

Propriété Type Description
traceid string ID, le cas échéant, de la trace pendant laquelle la mesure a été enregistrée.
Colonne de la source de données : Exemplars.TraceId.
spanid string ID, le cas échéant, du span pendant lequel la mesure a été enregistrée.
Colonne de la source de données : Exemplars.SpanId.
value float Valeur de la mesure.
Colonne de la source de données : Exemplars.Value.
time_unix integer Heure Unix (en nanosecondes) à laquelle la mesure a été enregistrée.
Colonne de la source de données : Exemplars.TimeUnix.
filtered_attributes object Attributs clé-valeur de la mesure qui ne sont pas inclus dans les attributes du point de données.
Colonne de la source de données : Exemplars.FilteredAttributes.