Actions New Relic Ingest

Aperçu

Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez !

Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos politiques de pré-sortie.

Cette page fournit une référence complète des actions d'ingestion New Relic disponibles dans le catalogue des actions d'automatisation des workflows. Ces actions vous permettent d'envoyer des événements et des logs à New Relic.

Prérequis

Avant d'utiliser les actions New Relic dans l'automatisation workflow, assurez-vous de disposer de :

Un compte New Relic disposant des autorisations appropriées.
Une clé de licence New Relic (si vous envoyez des données vers un compte différent).
Les autorisations nécessaires pour les services New Relic spécifiques que vous prévoyez d'utiliser.

Consultez la clé de licence pour obtenir des informations sur la façon de créer et de gérer votre compte New Relic.

actions d'ingestion de données

Signale un événement personnalisé à New Relic.

Champ de saisie	optionnalité	Type	Description	Exemple
attributes	Facultatif	Carte	Attributs courants qui font partie de tous les événements lorsqu'ils sont fournis. Fusion pour chaque élément d'événement lorsque l'élément d'événement doit remplacer la définition commune.	`"{\"page\": \"1\", \"limit\": \"10\"}"`
événement	Requis	List	La liste des données d'événement. Important Les événements nécessitent l'utilisation d'un champ `eventType` qui représente le type d'événement personnalisé. Le nombre maximal d'événements autorisés par requête est de 100.	`"[{\"eventType\":\"XYZ\",\"attributes\":{\"foo\":\"bar\"}}, {\"eventType\":\"ABC\",\"value\":\"1234\",\"attributes\":{\"color\":\"red\"}}]"`
clé de licence	Facultatif	Chaîne	La Clé de licence du compte New Relic (obligatoire) 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.	`"{{ .secrets.secretName }}"` , où `secretName` est la clé sous laquelle la clé de licence est stockée.
sélecteurs	Facultatif	List	Les sélecteurs permettant d'obtenir uniquement les paramètres spécifiés en sortie.	`[{\"name\": \"success\", \"expression\": \".success\"}]`

Champ de sortie	Type
succès	Booléen
message d'erreur	chaîne

Exemple de workflow
name: heartbeat_newrelicIngestSendEvents workflowInputs: cellName: type: String steps: - name: runAction type: action action: newrelic.ingest.sendEvents version: 1 inputs: attributes: colour: red id: 1234 events: - eventType: HeartBeat test: "OK" attributes: foo: bar - eventType: HeartBeat1234 test: "OK1234" attributes: foo: bar - eventType: HeartBeat12345 test: "OK12345" attributes: foo: bar colour: yellow - eventType: HeartBeat12345678 test: "OK12345678" selectors: - name: success expression: ".success" Résultat attendu : `{ "success": true }` Récupérer l'événement : Une fois un workflow exécuté avec succès, vous pouvez récupérer l'événement associé en exécutant une requête sous le compte qui a exécuté le workflow: `SELECT * FROM HeartBeat`

Exemple de workflow

name: heartbeat_newrelicIngestSendEvents

workflowInputs:
cellName:
  type: String

steps:
- name: runAction
  type: action
  action: newrelic.ingest.sendEvents
  version: 1
  inputs:
    attributes:
      colour: red
      id: 1234
    events:
      - eventType: HeartBeat
        test: "OK"
        attributes:
          foo: bar
      - eventType: HeartBeat1234
        test: "OK1234"
        attributes:
          foo: bar
      - eventType: HeartBeat12345
        test: "OK12345"
        attributes:
          foo: bar
          colour: yellow
      - eventType: HeartBeat12345678
        test: "OK12345678"
    selectors:
      - name: success
        expression: ".success"

Résultat attendu :

{
  "success": true
}

Récupérer l'événement :

Une fois un workflow exécuté avec succès, vous pouvez récupérer l'événement associé en exécutant une requête sous le compte qui a exécuté le workflow:

SELECT * FROM HeartBeat

Envoyer les logs à New Relic

Champ de saisie	optionnalité	Type	Description	Exemple
attributes	Facultatif	Carte	Les attributs communs sont inclus dans tous les logs lorsqu'ils sont fournis. Ceux-ci fusionnent avec chaque élément de log, les valeurs spécifiques au log remplaçant les attributs communs en cas de conflit.	`"{\"page\": \"1\", \"limit\": \"10\"}"`
logs	Requis	List	Liste des logs. Chaque log nécessite un champ `message` . Maximum de 100 logs par requête.	`"[{\"message\":\"XYZ\",\"attributes\":{\"foo\":\"bar\"}}, {\"message\":\"ABC\",\"value\":\"1234\",\"attributes\":{\"color\":\"red\"}}]"`
clé de licence	Facultatif	Chaîne	La Clé de licence du compte New Relic (obligatoire) 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.	`"{{ .secrets.secretName }}"` , où `secretName` est la clé sous laquelle la clé de licence est stockée.
sélecteurs	Facultatif	List	Les sélecteurs permettant d'obtenir uniquement les paramètres spécifiés en sortie.

Champ de sortie	Type
succès	Booléen
message d'erreur	chaîne

Exemple de workflow
`name: heartbeat_newrelicIngestSendLogs workflowInputs: cellName: type: String steps: - name: runAction type: action action: newrelic.ingest.sendLogs version: 1 inputs: attributes: colour: red id: 1234 logs: - message: 'Heartbeat sendLogs Action Test Message' attributes: foo: bar - message: 'HeartBeat1234' attributes: foo: bar - message: 'HeartBeat12345' attributes: foo: bar colour: yellow - message: 'HeartBeat12345678' selectors: - name: success expression: ".success"` Résultat attendu : `{ "success": true }` Récupérer les logs : Une fois un workflow exécuté avec succès, vous pouvez récupérer le log associé en exécutant une requête sous le compte qui a exécuté le workflow: `SELECT * FROM Log`

Exemple de workflow

name: heartbeat_newrelicIngestSendLogs

workflowInputs:
cellName:
  type: String

steps:
- name: runAction
  type: action
  action: newrelic.ingest.sendLogs
  version: 1
  inputs:
    attributes:
      colour: red
      id: 1234
    logs:
      - message: 'Heartbeat sendLogs Action Test Message'
        attributes:
          foo: bar
      - message: 'HeartBeat1234'
        attributes:
          foo: bar
      - message: 'HeartBeat12345'
        attributes:
          foo: bar
          colour: yellow
      - message: 'HeartBeat12345678'
    selectors:
      - name: success
        expression: ".success"

Résultat attendu :

{
  "success": true
}

Récupérer les logs :

Une fois un workflow exécuté avec succès, vous pouvez récupérer le log associé en exécutant une requête sous le compte qui a exécuté le workflow:

SELECT * FROM Log

Champ de saisie	optionnalité	Type	Exemple
metrics	Requis	List	`[ { "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	Facultatif	Carte	`{ "timestamp": 1531414060739, "interval.ms": 10000, "attributes": { "app.name": "foo", "host.name": "dev.server.com" } }`
clé de licence	Facultatif	Chaîne	La Clé de licence du compte New Relic (obligatoire) 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. `"{{ .secrets.secretName }}"`, où `secretName` est la clé sous laquelle la clé de licence est stockée.
sélecteurs	Facultatif	List	`[{"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	optionnalité	Description
name	Chaîne	Requis	Le nom de la métrique. La valeur doit comporter moins de 255 caractères.
valeur	Nombre ou Carte	Requis	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 clé-valeur 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 l'interrogation. 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		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 clé-valeur 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	optionnalité	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 temporelle.
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

optionnalité

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 temporelle.

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.

Champ de sortie	Type	Exemple
requestId	Chaîne	`13325ef9-0001-b193-510f-019ba20b0792`
succès	Booléen	`success: true \| false`
message d'erreur	Chaîne	`Failure reason as message.`

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é.

Aperçu

Prérequis

actions d'ingestion de données

Envoyer un événement personnalisé à New Relic

Important

Envoyer les logs à New Relic

Envoyer des métriques à New Relic

Important

Cette traduction automatique est fournie pour votre commodité.

Actions New Relic Ingest

Aperçu

Prérequis.css-21sua1{background:none;border:none;width:0;padding:0;}

actions d'ingestion de données

Envoyer les logs à New Relic

Envoyer des métriques à New Relic

Prérequis