• /
  • EnglishEspañolFrançais日本語한국어Português
  • EntrarComeçar agora

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

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Ações de configuração do New Relic Logs

|View as Markdown (English)

Esta página fornece uma referência para as ações de configuração do New Relic Logs disponíveis no catálogo de ações de automação de fluxo de trabalho. Essas ações podem ser usadas para consultar recursos de configuração de log — regras de análise, regras de partição de dados, expressão de ofuscação e regra de ofuscação, e configurações de pipeline — e realizar operações como validar padrões Grok e atualizar a configuração de pipeline, diretamente de uma definição de fluxo de trabalho.

Pré-requisitos

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

  • Uma conta New Relic com as permissões apropriadas para acessar a configuração de gerenciamento de logs.
  • O ID da conta para cada conta cuja configuração de log você deseja consultar ou atualizar.

Listar regras de análise

O identificador da ação é newrelic.logConfigurations.listParsingRules.

Retorna todas as regras de análise de log configuradas para uma conta.

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

Entrada

Tipo

Descrição

Exemplo

ID da conta

Inteiro

Obrigatório. A conta do New Relic para a qual listar as regras de análise. Deve ser um número inteiro positivo.

123456

selectors

Lista

Opcional. Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "parsingRules", "expression": ".data.actor.account.logConfigurations.parsingRules"}]

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

Saída

Tipo

Exemplo

success

Boleano

true quando a etapa foi executada sem erro.

errorMessage

Corda

Preenchido apenas se a chamada falhar no nível de HTTP/transporte. null em caso de sucesso.

data

Objeto

{
"data": {
"actor": {
"account": {
"logConfigurations": {
"parsingRules": [
{
"id": "123",
"accountId": 123456,
"description": "Parse nginx access logs",
"enabled": true,
"grok": "%{IP:clientip} %{WORD:method} %{URIPATHPARAM:request}",
"lucene": "logtype:nginx",
"nrql": "SELECT * FROM Log WHERE logtype = 'nginx'",
"attribute": "message",
"deleted": false,
"source": "USER",
"updatedAt": "2026-08-01T12:00:00Z"
}
]
}
}
}
}
}

source é um enum não nulo: USER ou BUILT_IN. updatedAt é anulável.

Exemplo de fluxo de trabalho

name: list_log_parsing_rules
description: Audit all active log parsing rules for an account
steps:
- name: listParsingRules
type: action
action: newrelic.logConfigurations.listParsingRules
version: 1
inputs:
accountId: 123456
selectors:
- name: parsingRules
expression: ".data.actor.account.logConfigurations.parsingRules"
next: end

Listar regras de partição de dados

O identificador da ação é newrelic.logConfigurations.listDataPartitionRules.

Retorna todas as regras de partição de dados de log configuradas para uma conta, incluindo o liveArchiveConfiguration aninhado para cada partição.

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

Entrada

Tipo

Descrição

Exemplo

ID da conta

Inteiro

Obrigatório. A conta da New Relic para listar as regras de partição de dados. Deve ser um número inteiro positivo.

123456

selectors

Lista

Opcional. Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "partitions", "expression": ".data.actor.account.logConfigurations.dataPartitionRules"}]

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

Saída

Tipo

Exemplo

success

Boleano

true quando a etapa foi executada sem erro.

errorMessage

Corda

Preenchido apenas se a chamada falhar no nível de HTTP/transporte. null em caso de sucesso.

data

Objeto

{
"data": {
"actor": {
"account": {
"logConfigurations": {
"dataPartitionRules": [
{
"id": "456",
"targetDataPartition": "Log_nginx",
"description": "Routes nginx logs to a dedicated partition",
"enabled": true,
"nrql": "logtype = 'nginx'",
"retentionPolicy": "STANDARD",
"deleted": false,
"createdAt": "2026-08-01T12:00:00Z",
"updatedAt": "2026-08-01T12:00:00Z",
"liveArchiveConfiguration": {
"id": "789",
"enabled": false,
"retentionPolicy": "STANDARD",
"eventType": "Log"
}
}
]
}
}
}
}
}

description, nrql, retentionPolicy e updatedAt são anuláveis. liveArchiveConfiguration.retentionPolicy é não nulo.

Exemplo de fluxo de trabalho

name: list_data_partition_rules
description: Audit how logs are routed across data partitions
steps:
- name: listDataPartitionRules
type: action
action: newrelic.logConfigurations.listDataPartitionRules
version: 1
inputs:
accountId: 123456
selectors:
- name: partitions
expression: ".data.actor.account.logConfigurations.dataPartitionRules"
next: end

Listar expressão de ofuscação

O identificador da ação é newrelic.logConfigurations.listObfuscationExpressions.

Retorna toda a expressão de ofuscação configurada para uma conta. A expressão de ofuscação define os padrões regex que a regra de ofuscação usa para corresponder a dados confidenciais em logs.

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

Entrada

Tipo

Descrição

Exemplo

ID da conta

Inteiro

Obrigatório. A conta da New Relic para a qual listar expressões de ofuscação. Deve ser um número inteiro positivo.

123456

selectors

Lista

Opcional. Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "expressions", "expression": ".data.actor.account.logConfigurations.obfuscationExpressions"}]

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

Saída

Tipo

Exemplo

success

Boleano

true quando a etapa foi executada sem erro.

errorMessage

Corda

Preenchido apenas se a chamada falhar no nível de HTTP/transporte. null em caso de sucesso.

data

Objeto

{
"data": {
"actor": {
"account": {
"logConfigurations": {
"obfuscationExpressions": [
{
"id": "abc123",
"name": "Credit card number",
"description": "Matches 13-16 digit credit card numbers",
"regex": "(\\b\\d{13,16}\\b)",
"createdAt": "2026-08-01T12:00:00Z",
"updatedAt": "2026-08-01T12:00:00Z"
}
]
}
}
}
}
}

description pode ser nulo.

Exemplo de fluxo de trabalho

name: list_obfuscation_expressions
description: Verify sensitive data patterns are configured for an account
steps:
- name: listObfuscationExpressions
type: action
action: newrelic.logConfigurations.listObfuscationExpressions
version: 1
inputs:
accountId: 123456
selectors:
- name: expressions
expression: ".data.actor.account.logConfigurations.obfuscationExpressions"
next: end

Listar regras de ofuscação

O identificador da ação é newrelic.logConfigurations.listObfuscationRules.

Retorna todas as regras de ofuscação configuradas para uma conta, incluindo as ações e expressões que cada regra aplica.

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

Entrada

Tipo

Descrição

Exemplo

ID da conta

Inteiro

Obrigatório. A conta New Relic para a qual listar a regra de ofuscação. Deve ser um número inteiro positivo.

123456

selectors

Lista

Opcional. Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "rules", "expression": ".data.actor.account.logConfigurations.obfuscationRules"}]

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

Saída

Tipo

Exemplo

success

Boleano

true quando a etapa foi executada sem erro.

errorMessage

Corda

Preenchido apenas se a chamada falhar no nível de HTTP/transporte. null em caso de sucesso.

data

Objeto

{
"data": {
"actor": {
"account": {
"logConfigurations": {
"obfuscationRules": [
{
"id": "rule123",
"name": "Mask credit cards",
"description": "Obfuscates credit card numbers in all logs",
"enabled": true,
"filter": "SELECT * FROM Log",
"actions": [
{
"id": "act456",
"attributes": ["message", "body"],
"expression": {
"id": "abc123",
"name": "Credit card number",
"regex": "(\\b\\d{13,16}\\b)"
},
"method": "MASK"
}
],
"createdAt": "2026-08-01T12:00:00Z",
"updatedAt": "2026-08-01T12:00:00Z"
}
]
}
}
}
}
}

description é anulável. filter é do tipo Nrql. actions[].attributes é uma lista de strings de nomes de atributos. actions[].expression é o objeto completo da expressão de ofuscação.

Exemplo de fluxo de trabalho

name: list_obfuscation_rules
description: Audit which sensitive-data obfuscation rules are active
steps:
- name: listObfuscationRules
type: action
action: newrelic.logConfigurations.listObfuscationRules
version: 1
inputs:
accountId: 123456
selectors:
- name: rules
expression: ".data.actor.account.logConfigurations.obfuscationRules"
next: end

Obter configuração de pipeline

O identificador da ação é newrelic.logConfigurations.getPipelineConfiguration.

Recupera a configuração atual do pipeline de logs para uma conta, mostrando quais etapas de processamento o pipeline habilita ou desabilita.

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

Entrada

Tipo

Descrição

Exemplo

ID da conta

Inteiro

Obrigatório. A conta da New Relic para recuperar a configuração do pipeline. Deve ser um número inteiro positivo.

123456

selectors

Lista

Opcional. Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "config", "expression": ".data.actor.account.logConfigurations.pipelineConfiguration"}]

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

Saída

Tipo

Exemplo

success

Boleano

true quando a etapa foi executada sem erro.

errorMessage

Corda

Preenchido apenas se a chamada falhar no nível de HTTP/transporte. null em caso de sucesso.

data

Objeto

{
"data": {
"actor": {
"account": {
"logConfigurations": {
"pipelineConfiguration": {
"accountId": 123456,
"accountLevelNativeJsonEnabled": false,
"enrichmentDisabled": false,
"entitySynthesisDisabled": false,
"hasNativeJsonEntitlementEnabled": false,
"infraAgentAttributesCleanupEnabled": false,
"jsonParsingDisabled": false,
"nrLinkingExtractionDisabled": false,
"nrUnmarshallingFieldsDisabled": false,
"obfuscationDisabled": false,
"parsingDisabled": false,
"patternsEnabled": true,
"pluginAttributesCleanupEnabled": false,
"recursiveJsonParsingDisabled": false,
"syslogJsonParsingDisabled": false,
"transformationDisabled": false,
"updatedAt": "2026-08-01T12:00:00Z"
}
}
}
}
}
}

updatedAt pode ser nulo — null se a configuração nunca foi alterada dos padrões.

Exemplo de fluxo de trabalho

name: get_pipeline_configuration
description: Read current pipeline configuration before making changes
steps:
- name: getPipelineConfiguration
type: action
action: newrelic.logConfigurations.getPipelineConfiguration
version: 1
inputs:
accountId: 123456
selectors:
- name: pipelineConfig
expression: ".data.actor.account.logConfigurations.pipelineConfiguration"
next: end

Testar um padrão Grok

O identificador da ação é newrelic.logConfigurations.testGrok.

Testa um padrão Grok em uma ou mais linhas de log de amostra e retorna se cada linha correspondeu, juntamente com os atributos extraídos. Você pode usar esta ação para validar um padrão Grok antes de criar uma regra de análise.

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

Entrada

Tipo

Descrição

Exemplo

ID da conta

Inteiro

Obrigatório. A conta do New Relic na qual testar o padrão Grok. Deve ser um número inteiro positivo.

123456

grok

Corda

Obrigatório. O padrão Grok a ser testado nas linhas de log.

"sampleattribute=%{NUMBER:test:int}"

logLines

Lista

Obrigatório. Linhas de log de exemplo para testar o padrão Grok.

["sampleattribute=42", "sampleattribute=hello"]

selectors

Lista

Opcional. Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "grokResults", "expression": ".data.actor.account.logConfigurations.testGrok"}]

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

Saída

Tipo

Exemplo

success

Boleano

true quando a etapa foi executada sem erro.

errorMessage

Corda

Preenchido apenas se a chamada falhar no nível de HTTP/transporte. null em caso de sucesso.

data

Objeto

{
"data": {
"actor": {
"account": {
"logConfigurations": {
"testGrok": [
{
"logLine": "sampleattribute=42",
"matched": true,
"attributes": [
{
"name": "test",
"value": "42"
}
]
},
{
"logLine": "sampleattribute=hello",
"matched": false,
"attributes": []
}
]
}
}
}
}
}

Exemplo de fluxo de trabalho

name: test_grok_pattern
description: Validate a Grok pattern against sample log lines before creating a parsing rule
steps:
- name: testGrokPattern
type: action
action: newrelic.logConfigurations.testGrok
version: 1
inputs:
accountId: 123456
grok: "sampleattribute=%{NUMBER:test:int}"
logLines:
- "sampleattribute=42"
- "sampleattribute=hello"
selectors:
- name: grokResults
expression: ".data.actor.account.logConfigurations.testGrok"
next: end

Atualizar a configuração do pipeline

O identificador da ação é newrelic.logConfigurations.upsertPipelineConfiguration.

Cria ou atualiza a configuração de pipeline de log para uma conta, controlando quais etapas de processamento o pipeline habilita. Todas as entradas de sinalizador são opcionais — omitir um sinalizador deixa o valor atual inalterado.

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

Entrada

Tipo

Descrição

Exemplo

ID da conta

Inteiro

Obrigatório. A conta New Relic na qual atualizar a configuração de pipeline. Deve ser um número inteiro positivo.

123456

accountLevelNativeJsonEnabled

Boleano

Opcional. Habilitar a análise nativa de JSON no nível da conta.

false

enrichmentDisabled

Boleano

Opcional. Desativar enriquecimento de log.

false

entitySynthesisDisabled

Boleano

Opcional. Desativar a síntese de entidade a partir de logs.

false

hasNativeJsonEntitlementEnabled

Boleano

Opcional. Ativar direito a JSON nativo.

false

infraAgentAttributesCleanupEnabled

Boleano

Opcional. Habilitar a limpeza de atributos do agente de infraestrutura.

false

jsonParsingDisabled

Boleano

Opcional. Desativar a análise JSON de mensagens do log.

false

nrLinkingExtractionDisabled

Boleano

Opcional. Desativar a extração de metadados de vinculação do New Relic.

false

nrUnmarshallingFieldsDisabled

Boleano

Opcional. Desabilitar a desserialização de campo da New Relic.

false

obfuscationDisabled

Boleano

Opcional. Desabilitar o processamento de ofuscação.

false

parsingDisabled

Boleano

Opcional. Desativar regras de análise de log.

false

patternsEnabled

Boleano

Opcional. Habilitar o recurso de Padrões de log.

true

pluginAttributesCleanupEnabled

Boleano

Opcional. Habilitar a limpeza de atributos de plug-in.

false

recursiveJsonParsingDisabled

Boleano

Opcional. Desativar análise recursiva de JSON.

false

syslogJsonParsingDisabled

Boleano

Opcional. Desativar a análise JSON para mensagens do syslog.

false

transformationDisabled

Boleano

Opcional. Desabilitar as regras de transformação de log.

false

selectors

Lista

Opcional. Seletores JQ para extrair campos específicos da saída da ação.

[{"name": "pipelineConfiguration", "expression": ".data.logConfigurationsUpsertPipelineConfiguration.pipelineConfiguration"}]

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

Saída

Tipo

Exemplo

success

Boleano

true quando a etapa foi executada sem erro.

errorMessage

Corda

Preenchido apenas se a chamada falhar no nível de HTTP/transporte. null em caso de sucesso.

data

Objeto

{
"data": {
"logConfigurationsUpsertPipelineConfiguration": {
"pipelineConfiguration": {
"accountId": 123456,
"accountLevelNativeJsonEnabled": false,
"enrichmentDisabled": false,
"entitySynthesisDisabled": false,
"hasNativeJsonEntitlementEnabled": false,
"infraAgentAttributesCleanupEnabled": false,
"jsonParsingDisabled": false,
"nrLinkingExtractionDisabled": false,
"nrUnmarshallingFieldsDisabled": false,
"obfuscationDisabled": false,
"parsingDisabled": false,
"patternsEnabled": true,
"pluginAttributesCleanupEnabled": false,
"recursiveJsonParsingDisabled": false,
"syslogJsonParsingDisabled": false,
"transformationDisabled": false,
"updatedAt": "2026-10-15T10:00:00Z"
}
}
}
}

updatedAt pode ser nulo — null se a configuração nunca foi alterada dos padrões.

Exemplo de fluxo de trabalho

name: update_pipeline_configuration
description: Disable parsing and obfuscation temporarily during an incident
steps:
- name: upsertPipelineConfiguration
type: action
action: newrelic.logConfigurations.upsertPipelineConfiguration
version: 1
inputs:
accountId: 123456
parsingDisabled: false
obfuscationDisabled: false
patternsEnabled: true
selectors:
- name: pipelineConfiguration
expression: ".data.logConfigurationsUpsertPipelineConfiguration.pipelineConfiguration"
next: end
Copyright © 2026 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.