Enviar métrica para New Relic

Envia pontos de dados de métrica para o New Relic.

Para pré-requisitos, consulte as ações do New Relic Ingest.

O identificador da ação é newrelic.ingest.sendMetrics.

Envia métricas para o New Relic.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada	Tipo	Descrição	Exemplo
métrica	Lista	Obrigatório. Lista de pontos de dados de métrica. Consulte Pares de valor principal obrigatórios no `metrics` para ver a estrutura esperada de cada item.	`[ { "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 comuns para aplicar em todas as métricas. Consulte Compartilhar atributos entre métricas com `common` para obter detalhes.	`{ "timestamp": 1531414060739, "interval.ms": 10000, "attributes": { "app.name": "foo", "host.name": "dev.server.com" } }`
chave de licença	Corda	Opcional. A chave de licença da conta New Relic especifica a conta de destino para seus eventos. Caso não seja fornecida, o sistema usa a chave de licença padrão da conta que executa o fluxo de trabalho. Leia mais sobre nossas chaves de API para criar e gerenciar sua chave de licença da conta New Relic. Não insira credenciais em texto simples. Use a sintaxe de segredos mostrada no exemplo.	`"{{ .secrets.secretName }}"`, onde `secretName` é a chave sob a qual a chave de licença está armazenada.
selectors	Lista	Opcional. Os seletores para obter apenas o parâmetro especificado como saída.	`[{"name": "error", "expression": ".errorMessage"}]`

Pares de chave-valor obrigatórios no `metrics`

Cada mapa de ponto de dados de métrica na lista metrics usa a seguinte estrutura de chave-valor:

Atributo	Tipo	Descrição
nome	Corda	Obrigatório. O nome da métrica. O valor deve ter menos de 255 caracteres.
valor	Número ou Mapa	Obrigatório. O valor varia dependendo do tipo de métrica . Para `gauge` e `count` , o valor deve ser um único número. Para `summary` , o valor deve ser um mapa com pares valor principal especificando a contagem, soma, mínimo e máximo.
Timestamp	Longo	Opcional. O horário de início da métrica em tempo Unix . O padrão usa o fuso horário UTC. Este campo também suporta segundos, microssegundos e nanossegundos. No entanto, os dados serão convertidos em milissegundos para armazenamento e consulta. As métricas são descartadas se tiverem um timestamp com mais de 48 horas no passado ou mais de 24 horas no futuro a partir do momento em que são relatadas.
intervalo.ms	Positivo longo	Obrigatório para `count` e `summary` tipos de métricas . A duração da janela de tempo.
type	Corda	Recomendado. Suporta apenas `count` , `gauge` , `summary` . Veja tipos de métricas suportados para mais informações. Se você não especificar um tipo, o padrão será `gauge` .
atributo	Strings, números JSON ou booleanos	Recomendado. Um mapa de pares valor principal associados a esta métrica específica. Os valores podem ser strings, números JSON ou booleanos. As chaves diferenciam maiúsculas de minúsculas e devem ter menos de 255 caracteres.

Importante

A API de métricas exige um timestamp. Dentro da ação, o timestamp é opcional, com o padrão sendo a hora atual se não fornecido antes da ingestão de métricas.

Compartilhe atributo entre métricas com `common`

Se você deseja incluir um conjunto de atributos em várias métricas (e não adicionar os mesmos atributos para cada métrica), você pode usar o bloco common. Este é um mapa opcional que especifica informações que se aplicam a todos os pontos de dados de métricas associados. Os valores na seção common serão substituídos se a mesma chave existir em um ponto de dados de métrica.

O bloco pode incluir:

Atributo	Tipo	Descrição
Timestamp	Longo	A hora de início da métrica no horário Unix . O padrão é a hora atual no fuso horário UTC. Este campo também oferece suporte a segundos, microssegundos e nanossegundos. Porém, os dados serão convertidos em milissegundos para armazenamento e consulta posterior.
intervalo.ms	Positivo longo	Obrigatório para `count` e `summary` . A duração da janela de tempo.
atributo	Strings, números JSON ou booleanos	Um mapa de pares de valores principais associados a esta métrica específica. Os valores podem ser strings, números JSON ou booleanos.

Atributo

Tipo

Descrição

Timestamp

Longo

A hora de início da métrica no

horário Unix

. O padrão é a hora atual no fuso horário UTC. Este campo também oferece suporte a segundos, microssegundos e nanossegundos. Porém, os dados serão convertidos em milissegundos para armazenamento e consulta posterior.

intervalo.ms

Positivo longo

Obrigatório

para

count

summary

. A duração da janela de tempo.

atributo

Strings, números JSON ou booleanos

Um mapa de pares de valores principais associados a esta métrica específica. Os valores podem ser strings, números JSON ou booleanos.

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída	Tipo	Descrição
requestId	Corda	O identificador da solicitação atribuído pela API de métricas. Exemplo: `13325ef9-0001-b193-510f-019ba20b0792` .
success	Boleano	`true` em caso de sucesso, `false` em caso de falha.
errorMessage	Corda	Motivo da falha como mensagem. `null` em caso de sucesso.

Saída

Tipo

Descrição

requestId

Corda

O identificador da solicitação atribuído pela API de métricas. Exemplo:

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

success

Boleano

true

em caso de sucesso,

false

em caso de falha.

errorMessage

Corda

Motivo da falha como mensagem.

null

em caso de sucesso.

O exemplo a seguir envia dois pontos de dados de métrica — uma contagem e um medidor — com atributos de timestamp e código de status.

Exemplo de fluxo de trabalho
`- 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`

Exemplo de fluxo de trabalho

- 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

Esta tradução de máquina é fornecida para sua comodidade.

Enviar métrica para New Relic