Acciones de ingesta New Relic

avance

Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras!

Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras políticas de prelanzamiento.

Esta página proporciona una referencia completa de las acciones de ingesta de New Relic disponibles en el catálogo de acciones de automatización de flujo de trabajo. Estas acciones le permiten enviar eventos y logs a New Relic.

Requisitos previos

Antes de emplear las acciones New Relic en la automatización del flujo de trabajo, cerciorar de tener lo siguiente:

Una cuenta de New Relic con las licencias adecuadas.
Una clave de licencia de New Relic (si se envían datos a una cuenta diferente).
Las licencias necesarias para los servicios específicos de New Relic que planea emplear.

Consulte la clave de licencia para obtener información sobre cómo crear y gestionar su clave de licencia de cuenta de New Relic.

acciones de ingesta de datos

Informa un evento personalizado a New Relic.

Campo de entrada	Opcionalidad	Tipo	Descripción	Ejemplo
Atributo	Opcional	Mapa	Atributo común que forma parte de todos los eventos cuando se proporcionan. La fusión de cada elemento de evento cuando es necesario anula la definición común.	`"{\"page\": \"1\", \"limit\": \"10\"}"`
evento	Requerido	Lista	La lista de datos de eventos. Importante evento requiere el uso de un campo `eventType` que representa el tipo de evento personalizado. El máximo de eventos permitidos por solicitud es 100.	`"[{\"eventType\":\"XYZ\",\"attributes\":{\"foo\":\"bar\"}}, {\"eventType\":\"ABC\",\"value\":\"1234\",\"attributes\":{\"color\":\"red\"}}]"`
clave de licencia	Opcional	Cadena	La clave de licencia de cuenta deNew Relic (obligatoria) especifica la cuenta de destino para su evento. Si no se proporciona, el sistema emplea la clave de licencia predeterminada de la cuenta que ejecuta el flujo de trabajo. Obtenga más información sobre nuestra clave de API para crear y gestionar su clave de licencia de cuentaNew Relic .	`"{{ .secrets.secretName }}"` , donde `secretName` es la clave bajo la cual se almacena la clave de licencia.
selectores	Opcional	Lista	Los selectores para obtener únicamente el parámetro especificado como resultado.	`[{\"name\": \"success\", \"expression\": \".success\"}]`

Campo de salida	Tipo
éxito	Booleano
mensaje de error	cadena

Ejemplo de flujo de trabajo
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" Resultado esperado: `{ "success": true }` Recuperar evento: Tras ejecutar correctamente un flujo de trabajo, puede recuperar el evento asociado ejecutando una consulta en la cuenta que ejecutó el flujo de trabajo: `SELECT * FROM HeartBeat`

Ejemplo de flujo de trabajo

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"

Resultado esperado:

{
  "success": true
}

Recuperar evento:

Tras ejecutar correctamente un flujo de trabajo, puede recuperar el evento asociado ejecutando una consulta en la cuenta que ejecutó el flujo de trabajo:

SELECT * FROM HeartBeat

Enviar log a New Relic

Campo de entrada	Opcionalidad	Tipo	Descripción	Ejemplo
Atributo	Opcional	Mapa	Los atributos comunes se incluyen en todos los logs cuando se proporcionan. Estos se fusionan con cada elemento del log, y los valores específicos del log anulan los atributos comunes cuando ocurren conflictos.	`"{\"page\": \"1\", \"limit\": \"10\"}"`
logs	Requerido	Lista	Lista de logs. Cada log requiere un campo `message` . Máximo de 100 logs por solicitud.	`"[{\"message\":\"XYZ\",\"attributes\":{\"foo\":\"bar\"}}, {\"message\":\"ABC\",\"value\":\"1234\",\"attributes\":{\"color\":\"red\"}}]"`
clave de licencia	Opcional	Cadena	La clave de licencia de cuenta deNew Relic (obligatoria) especifica la cuenta de destino para su evento. Si no se proporciona, el sistema emplea la clave de licencia predeterminada de la cuenta que ejecuta el flujo de trabajo. Obtenga más información sobre nuestra clave de API para crear y gestionar su clave de licencia de cuentaNew Relic .	`"{{ .secrets.secretName }}"` , donde `secretName` es la clave bajo la cual se almacena la clave de licencia.
selectores	Opcional	Lista	Los selectores para obtener únicamente el parámetro especificado como resultado.

Campo de salida	Tipo
éxito	Booleano
mensaje de error	cadena

Ejemplo de flujo de trabajo
`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"` Resultado esperado: `{ "success": true }` Recuperar logs: Tras ejecutar correctamente un flujo de trabajo, puede recuperar el log asociado ejecutando una consulta en la cuenta que ejecutó el flujo de trabajo: `SELECT * FROM Log`

Ejemplo de flujo de trabajo

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"

Resultado esperado:

{
  "success": true
}

Recuperar logs:

Tras ejecutar correctamente un flujo de trabajo, puede recuperar el log asociado ejecutando una consulta en la cuenta que ejecutó el flujo de trabajo:

SELECT * FROM Log

Campo de entrada	Opcionalidad	Tipo	Ejemplo
métrica	Requerido	Lista	`[ { "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" } } ]`
Atributo	Opcional	Mapa	`{ "timestamp": 1531414060739, "interval.ms": 10000, "attributes": { "app.name": "foo", "host.name": "dev.server.com" } }`
clave de licencia	Opcional	Cadena	La clave de licencia de cuenta deNew Relic (obligatoria) especifica la cuenta de destino para su evento. Si no se proporciona, el sistema emplea la clave de licencia predeterminada de la cuenta que ejecuta el flujo de trabajo. Obtenga más información sobre nuestra clave de API para crear y gestionar su clave de licencia de cuentaNew Relic . `"{{ .secrets.secretName }}"`, donde `secretName` es la clave bajo la cual se almacena la clave de licencia.
selectores	Opcional	Lista	`[{"name": "error", "expression": ".errorMessage"}]`

Pares clave-valor requeridos en el metrics

Cada punto de datos de métrica en la lista metrics utiliza la siguiente estructura clave-valor:

Atributo	Tipo	Opcionalidad	Descripción
nombre	Cadena	Requerido	El nombre de la métrica. El valor debe tener menos de 255 caracteres.
valor	Número o Mapa	Requerido	El valor varía según el tipo de métrica . Para `gauge` y `count` , el valor debe ser un solo número. Para `summary` , el valor debe ser un mapa con pares clave-valor que especifiquen el conteo, la suma, el mínimo y el máximo.
timestamp	Largo	Opcional	La hora de inicio de la métrica en tiempo Unix . El valor predeterminado utiliza la zona horaria UTC. Este campo también admite segundos, microsegundos y nanosegundos. Sin embargo, los datos se convertirán a milisegundos para su almacenamiento y consulta. Las métricas se descartan si tienen una marca de tiempo de más de 48 horas en el pasado o más de 24 horas en el futuro desde el momento en que se informan.
intervalo.ms	Largo positivo	Requerido para `count` y `summary` tipos de métricas .	La duración de la ventana de tiempo.
tipo		Recomendado	Solo admite `count` , `gauge` , `summary` , consulte tipos de métricas admitidos para obtener más información. Si no especifica un tipo, esto se establecerá de forma predeterminada en un `gauge` .
Atributo	Cadenas de texto, números JSON o booleanos	Recomendado	Un mapa de pares clave-valor asociados con esta métrica específica. Los valores pueden ser cadenas, números JSON o booleanos. Las claves distinguen entre mayúsculas y minúsculas y deben tener menos de 255 caracteres.

Importante

La API de métricas exige un timestamp. Dentro de la acción, el timestamp es opcional y, si no se proporciona antes de la ingesta de métricas, toma por defecto la hora actual.

Compartir atributo a través de métrica con common

Si desea incluir un conjunto de atributos en múltiples métricas (y no agregar los mismos atributos para cada métrica), puede usar el bloque common. Este es un mapa opcional que especifica información que se aplica a todos los puntos de datos de métricas asociados. Los valores en la sección common se anularán si la misma clave existe en un punto de datos de métrica.

El bloque puede incluir:

Atributo	Tipo	Opcionalidad	Descripción
timestamp	Largo		La hora de inicio de la métrica en tiempo Unix . El valor predeterminado es la hora actual en la zona horaria UTC. Este campo también admite segundos, microsegundos y nanosegundos. Sin embargo, los datos se convertirán a milisegundos para su almacenamiento y consulta posterior.
intervalo.ms	Largo positivo	Requerido para `count` y `summary`	La duración de la ventana de tiempo.
Atributo	Cadenas de texto, números JSON o booleanos		Un mapa de pares de valores principales asociados con esta métrica específica. Los valores pueden ser cadenas, números JSON o booleanos.

Atributo

Tipo

Opcionalidad

Descripción

timestamp

Largo

La hora de inicio de la métrica en

tiempo Unix

. El valor predeterminado es la hora actual en la zona horaria UTC. Este campo también admite segundos, microsegundos y nanosegundos. Sin embargo, los datos se convertirán a milisegundos para su almacenamiento y consulta posterior.

intervalo.ms

Largo positivo

Requerido para

count

summary

La duración de la ventana de tiempo.

Atributo

Cadenas de texto, números JSON o booleanos

Un mapa de pares de valores principales asociados con esta métrica específica. Los valores pueden ser cadenas, números JSON o booleanos.

Campo de salida	Tipo	Ejemplo
requestId	Cadena	`13325ef9-0001-b193-510f-019ba20b0792`
éxito	Booleano	`success: true \| false`
mensaje de error	Cadena	`Failure reason as message.`

Ejemplo de flujo de trabajo
`- 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`

Ejemplo de flujo de trabajo

- 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

Te ofrecemos esta traducción automática para facilitar la lectura.

avance

Requisitos previos

acciones de ingesta de datos

Enviar evento personalizado a New Relic

Importante

Enviar log a New Relic

Enviar métrica a New Relic

Importante

Te ofrecemos esta traducción automática para facilitar la lectura.

Acciones de ingesta New Relic

avance

Requisitos previos.css-21sua1{background:none;border:none;width:0;padding:0;}

acciones de ingesta de datos

Enviar log a New Relic

Enviar métrica a New Relic

Requisitos previos