Ações de ingestão do New Relic

Esta página fornece uma referência completa para as ações de ingestão do New Relic disponíveis no catálogo de ações de automação do fluxo de trabalho. Essas ações permitem que você envie eventos e logs para o New Relic.

Pré-requisitos

Antes de usar as ações New Relic na automação do fluxo de trabalho, certifique-se de ter:

Uma conta New Relic com as permissões apropriadas.
Uma chave de licença do New Relic (caso esteja enviando dados para uma conta diferente).
As permissões necessárias para os serviços específicos do New Relic que você planeja usar.

Consulte Chave de licença para obter informações sobre como criar e gerenciar a Chave de licença da sua conta New Relic.

Ações de ingestão de dados

Reporta um evento personalizado ao New Relic.

Campo de entrada	Opcionalidade	Tipo	Descrição	Exemplo
atributo	Opcional	Mapa	Atributo comum que faz parte de todos os eventos quando fornecido. A fusão de cada item de evento, quando necessário, substitui a definição comum.	`"{\"page\": \"1\", \"limit\": \"10\"}"`
eventos	Obrigatório	Lista	Lista de dados do evento. Importante O evento requer o uso de um campo `eventType` que representa o tipo personalizado do evento. O número máximo de eventos permitidos por solicitação é 100.	`"[{\"eventType\":\"XYZ\",\"attributes\":{\"foo\":\"bar\"}}, {\"eventType\":\"ABC\",\"value\":\"1234\",\"attributes\":{\"color\":\"red\"}}]"`
chave de licença	Opcional	Corda	A chave de licença da contaNew Relic (obrigatória) especifica a conta de destino para o seu evento. Caso não seja fornecida, o sistema utiliza 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.	`"{{ .secrets.secretName }}"` , onde `secretName` é a chave sob a qual a chave de licença está armazenada.
seletores	Opcional	Lista	Os seletores permitem obter apenas o parâmetro especificado como saída.	`[{\"name\": \"success\", \"expression\": \".success\"}]`

Campo de saída	Tipo
sucesso	Boleano
mensagem de erro	corda

Exemplo de fluxo de trabalho
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: Após executar um fluxo de trabalho com sucesso, você pode recuperar o evento associado executando uma consulta na conta que executou o fluxo de trabalho: `SELECT * FROM HeartBeat`

Exemplo de fluxo de trabalho

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:

Após executar um fluxo de trabalho com sucesso, você pode recuperar o evento associado executando uma consulta na conta que executou o fluxo de trabalho:

SELECT * FROM HeartBeat

Enviar registro para New Relic

Campo de entrada	Opcionalidade	Tipo	Descrição	Exemplo
atributo	Opcional	Mapa	Os atributos comuns são incluídos em todos os logs quando fornecidos. Esses valores são mesclados com cada item de log, sendo que os valores específicos de cada log têm precedência sobre os atributos comuns quando ocorrem conflitos.	`"{\"page\": \"1\", \"limit\": \"10\"}"`
logs	Obrigatório	Lista	Lista de logs. Cada log requer um campo `message` . Máximo de 100 logs por solicitação.	`"[{\"message\":\"XYZ\",\"attributes\":{\"foo\":\"bar\"}}, {\"message\":\"ABC\",\"value\":\"1234\",\"attributes\":{\"color\":\"red\"}}]"`
chave de licença	Opcional	Corda	A chave de licença da contaNew Relic (obrigatória) especifica a conta de destino para o seu evento. Caso não seja fornecida, o sistema utiliza 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.	`"{{ .secrets.secretName }}"` , onde `secretName` é a chave sob a qual a chave de licença está armazenada.
seletores	Opcional	Lista	Os seletores permitem obter apenas o parâmetro especificado como saída.

Campo de saída	Tipo
sucesso	Boleano
mensagem de erro	corda

Exemplo de fluxo de trabalho
`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: Após executar um fluxo de trabalho com sucesso, você pode recuperar o log associado executando uma consulta na conta que executou o fluxo de trabalho: `SELECT * FROM Log`

Exemplo de fluxo de trabalho

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:

Após executar um fluxo de trabalho com sucesso, você pode recuperar o log associado executando uma consulta na conta que executou o fluxo de trabalho:

SELECT * FROM Log

Campo de entrada	Opcionalidade	Tipo	Exemplo
métrica	Obrigatório	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" } }`
chave de licença	Opcional	Corda	A chave de licença da contaNew Relic (obrigatória) especifica a conta de destino para o seu evento. Caso não seja fornecida, o sistema utiliza 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. Veja abaixo um exemplo de sintaxe de segredos. Exemplo: `"{{ .secrets.secretName }}"`, onde `secretName` é a chave sob a qual a chave de licença é armazenada.
seletores	Opcional	Lista	`[{"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	Opcionalidade	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 chave-valor 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 carimbo de data/hora 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.
tipo		Recomendado	Suporta apenas `count` , `gauge` , `summary` , consulte tipos de métricas suportados para obter 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 chave-valor 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	Opcionalidade	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

Opcionalidade

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.

Campo de saída	Tipo	Exemplo
requestId	Corda	`13325ef9-0001-b193-510f-019ba20b0792`
sucesso	Boleano	`success: true \| false`
mensagem de erro	Corda	`Failure reason as message.`

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.

Pré-requisitos

Ações de ingestão de dados

Enviar evento personalizado para New Relic

Importante

Enviar registro para New Relic

Enviar métrica para New Relic

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

Importante

Compartilhe atributo entre métricas com `common`

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

Ações de ingestão do New Relic

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

Ações de ingestão de dados

Enviar registro para New Relic

Enviar métrica para New Relic

Pré-requisitos