Ações de ingestão do New Relic

visualização

Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse!

Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas políticas de pré-lançamento.

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 sua conta New Relic chave de licença.

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 nossa chave de API para criar e gerenciar sua contaNew 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 nossa chave de API para criar e gerenciar sua contaNew 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 nossa chave de API para criar e gerenciar sua contaNew Relic . `"{{ .secrets.secretName }}"`, onde `secretName` é a chave sob a qual a chave de licença está 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.

visualização

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

Importante

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

Ações de ingestão do New Relic

visualização

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