Enviar métrica a New Relic

Envía puntos de datos de métricas a New Relic.

Para los prerrequisitos, consulte las acciones de New Relic Ingest.

El identificador de la acción es newrelic.ingest.sendMetrics.

Envía métrica a New Relic.

La siguiente tabla describe todos los campos de entrada disponibles para esta acción.

Aporte	Tipo	Descripción	Ejemplo
métrica	Lista	Requerido. Lista de puntos de datos de métrica. Consulte Pares de valor principal requeridos en el `metrics` para conocer la estructura esperada de cada elemento.	`[ { "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	Mapa	Opcional. Atributos comunes para aplicar en todas las métricas. Consulte Compartir atributos entre métricas con `common` para obtener más detalles.	`{ "timestamp": 1531414060739, "interval.ms": 10000, "attributes": { "app.name": "foo", "host.name": "dev.server.com" } }`
clave de licencia	Cadena	Opcional. La clave de licencia de la cuenta de New Relic especifica la cuenta objetivo para los eventos. Si no se proporciona, el sistema usa la clave de licencia predeterminada de la cuenta que ejecuta el flujo de trabajo. Lea más sobre nuestras claves de API para crear y administrar la clave de licencia de la cuenta de New Relic. No ingrese credenciales en texto plano. Use la sintaxis de secretos que se muestra en el ejemplo.	`"{{ .secrets.secretName }}"`, donde `secretName` es la clave bajo la cual se almacena la clave de licencia.
selectors	Lista	Opcional. Los selectores para obtener únicamente el parámetro especificado como salida.	`[{"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	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 valor principal 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 un timestamp 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.
type	Cadena	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 valor principal 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	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 longitud 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

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

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción	Tipo	Descripción
requestId	Cadena	El identificador de la solicitud asignado por la API de métricas. Ejemplo: `13325ef9-0001-b193-510f-019ba20b0792` .
success	Booleano	`true` en caso de éxito, `false` en caso de falla.
errorMessage	Cadena	Motivo de la falla como mensaje. `null` en caso de éxito.

Producción

Tipo

Descripción

requestId

Cadena

El identificador de la solicitud asignado por la API de métricas. Ejemplo:

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

success

Booleano

true

en caso de éxito,

false

en caso de falla.

errorMessage

Cadena

Motivo de la falla como mensaje.

null

en caso de éxito.

El siguiente ejemplo envía dos puntos de datos de métrica —un recuento y un medidor— con atributos de timestamp y código de estado.

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.

Enviar métrica a New Relic