Envoyer des métriques à New Relic

Envoie des points de données métriques à New Relic.

Pour les prérequis, voir Actions New Relic Ingest.

L’identifiant de l’action est newrelic.ingest.sendMetrics.

Envoie des métriques à New Relic.

Le tableau suivant décrit tous les champs de saisie disponibles pour cette action.

Saisir	Type	Description	Exemple
metrics	List	Obligatoire. Liste des points de données de métrique. Consultez Paires valeur clé requises dans le `metrics` pour la structure attendue de chaque élément.	`[ { "name": "service.errors.all", "type": "count", "value": 9, "attributes": { "service.response.statuscode": "400" } },` `{ "name": "service.errors.all", "type": "gauge", "value": 4, "attributes": { "service.response.statuscode": "500" } },` `{ "name": "service.response.duration", "type": "summary", "value": { "count": 5, "sum": 0.004382655, "min": 0.0005093, "max": 0.001708826 }, "attributes": { "service.response.statuscode": "200" } } ]`
attributes	Carte	Facultatif. Attributs communs à appliquer à toutes les métriques. Consultez Partager des attributs entre les métriques avec `common` pour plus de détails.	`{ "timestamp": 1531414060739, "interval.ms": 10000, "attributes": { "app.name": "foo", "host.name": "dev.server.com" } }`
clé de licence	Chaîne	Facultatif. La clé de licence du compte New Relic spécifie le compte cible pour vos événements. Si elle n’est pas fournie, le système utilise la clé de licence par défaut du compte exécutant le workflow. En savoir plus sur nos clés API pour créer et gérer votre clé de licence de compte New Relic. Ne saisissez pas d’identifiants en clair. Utilisez la syntaxe des secrets indiquée dans l’exemple.	`"{{ .secrets.secretName }}"`, où `secretName` est la clé sous laquelle la clé de licence est stockée.
selectors	List	Facultatif. Les sélecteurs permettant d'obtenir uniquement les paramètres spécifiés en sortie.	`[{"name": "error", "expression": ".errorMessage"}]`

Paires clé-valeur requises dans le `metrics`

Chaque point de données de métrique dans la liste metrics utilise la structure clé-valeur suivante :

Attribut	Type	Description
name	Chaîne	Obligatoire. Le nom de la métrique. La valeur doit comporter moins de 255 caractères.
valeur	Nombre ou Carte	Obligatoire. La valeur varie en fonction du type de métrique . Pour `gauge` et `count` , la valeur doit être un seul nombre. Pour `summary` , la valeur doit être une carte avec des paires valeur clé spécifiant le compte, la somme, le min, et le max.
horodatage	Long	Facultatif. L’heure de début de la métrique en temps Unix . La valeur par défaut utilise le fuseau horaire UTC. Ce champ prend également en charge les secondes, les microsecondes et les nanosecondes. Cependant, les données seront converties en millisecondes pour le stockage et la requête. Les métriques sont supprimées si elles ont un horodatage de plus de 48 heures dans le passé ou de plus de 24 heures dans le futur par rapport à l’heure à laquelle elles sont signalées.
intervalle.ms	Positif long	Obligatoire pour `count` et `summary` types de métriques . La durée de la fenêtre temporelle.
type	Chaîne	Recommandé. Prend en charge uniquement `count` , `gauge` , `summary` . Voir types de métriques pris en charge pour plus d’informations. Si vous ne spécifiez pas de type, la valeur par défaut sera `gauge` .
attributes	Chaînes de caractères, nombres JSON ou booléens	Recommandé. Une carte des paires valeur clé associées à cette métrique spécifique. Les valeurs peuvent être des chaînes de caractères, des nombres JSON, ou des valeurs booléennes. Les clés sont sensibles à la casse, et doivent comporter moins de 255 caractères.

Important

L'API de métriques exige un timestamp. Dans l'action, le timestamp est facultatif, et prend par défaut l'heure actuelle s'il n'est pas fourni avant l'ingestion des métriques.

Partager l'attribut sur plusieurs métriques avec `common`

Si vous souhaitez inclure un ensemble d'attributs sur plusieurs métriques (et ne pas ajouter les mêmes attributs pour chaque métrique), vous pouvez utiliser le bloc common. Il s'agit d'une carte facultative qui spécifie les informations qui s'appliquent à tous les points de données de métriques associés. Les valeurs de la section common seront remplacées si la même clé existe sur un point de données de métrique.

Le bloc peut inclure :

Attribut	Type	Description
horodatage	Long	L'heure de début de la métrique en heure Unix . La valeur par défaut est l'heure actuelle dans le fuseau horaire UTC. Ce champ prend également en charge les secondes, les microsecondes et les nanosecondes. Cependant, les données seront converties en millisecondes pour le stockage et l'interrogation ultérieure.
intervalle.ms	Positif long	Requis pour `count` et `summary` . La durée de la fenêtre de temps.
attributes	Chaînes de caractères, nombres JSON ou booléens	Une carte des paires de valeurs clés associées à cette métrique spécifique. Les valeurs peuvent être des chaînes, des nombres JSON ou des booléens.

Attribut

Type

Description

horodatage

Long

L'heure de début de la métrique en

heure Unix

. La valeur par défaut est l'heure actuelle dans le fuseau horaire UTC. Ce champ prend également en charge les secondes, les microsecondes et les nanosecondes. Cependant, les données seront converties en millisecondes pour le stockage et l'interrogation ultérieure.

intervalle.ms

Positif long

Requis

pour

count

summary

. La durée de la fenêtre de temps.

attributes

Chaînes de caractères, nombres JSON ou booléens

Une carte des paires de valeurs clés associées à cette métrique spécifique. Les valeurs peuvent être des chaînes, des nombres JSON ou des booléens.

Le tableau suivant décrit tous les champs de sortie renvoyés par cette action.

Sortir	Type	Description
requestId	Chaîne	L’identifiant de la requête attribué par l’API de métriques. Exemple : `13325ef9-0001-b193-510f-019ba20b0792` .
success	Booléen	`true` en cas de succès, `false` en cas d’échec.
errorMessage	Chaîne	Motif de l'échec sous forme de message. `null` en cas de succès.

Sortir

Type

Description

requestId

Chaîne

L’identifiant de la requête attribué par l’API de métriques. Exemple :

13325ef9-0001-b193-510f-019ba20b0792

success

Booléen

true

en cas de succès,

false

en cas d’échec.

errorMessage

Chaîne

Motif de l'échec sous forme de message.

null

en cas de succès.

L’exemple suivant envoie deux points de données de métrique (un comptage et une jauge) avec des horodatages et des attributs de code d’état.

Exemple de workflow
`- name: sendMetrics type: action action: newrelic.ingest.sendMetrics version: 1 inputs: metrics: - name: service.errors.all type: count value: 9 timestamp: 1531414060739 attributes: service.response.statuscode: 400 - name: service.response.duration type: guage value: 4 timestamp: 1531414060733 attributes: service.response.statuscode: 500`

Exemple de workflow

- name: sendMetrics
    type: action
    action: newrelic.ingest.sendMetrics
    version: 1
    inputs:
      metrics:
        - name: service.errors.all
          type: count
          value: 9
          timestamp: 1531414060739
          attributes:
            service.response.statuscode: 400
        - name: service.response.duration
          type: guage
          value: 4
          timestamp: 1531414060733
          attributes:
            service.response.statuscode: 500

Cette traduction automatique est fournie pour votre commodité.

Envoyer des métriques à New Relic