Listar problemas da New Relic

Consulta e lista problemas de Inteligência de alerta do New Relic para uma conta com filtragem e paginação opcionais.

Para pré-requisitos, consulte as ações de Issue de New Relic.

Listar problemas

O identificador da ação é newrelic.issue.list.

Consulta e lista os problemas do New Relic (problemas de IA) para uma conta, retornando o status em tempo real, a linha do tempo, as entidades correlacionadas e os detalhes de impacto para problemas ativos ou passados. Oferece suporte à filtragem por estado, prioridade, origem, entidade, condição, política, status de correlação e reconhecimento, uma janela de tempo e paginação baseada em cursor. Desenvolvido em newrelic.nerdgraph.execute.

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

Entrada	Tipo	Descrição	Exemplo
ID da conta	Interno	Obrigatório. A conta New Relic cujos problemas devem ser listados. Deve ser um número inteiro positivo.	`123456`
issueIds	Lista	Opcional. IDs de problema a incluir. Deve ser uma matriz JSON de strings UUID.	`["123e4567-e89b-12d3-a456-426614174000"]`
estados	Lista	Opcional. Um ou mais de `ACTIVATED` , `CLOSED` , `CREATED` , `DEACTIVATED` .	`["ACTIVATED", "CREATED"]`
prioridade	Lista	Opcional. Um ou mais de `CRITICAL` , `HIGH` , `MEDIUM` , `LOW` .	`["CRITICAL", "HIGH"]`
fontes	Lista	Opcional. Um ou mais de `newrelic` (gerado pelo mecanismo de alertas do New Relic) ou `rest` (criado externamente via API REST).	`["newrelic"]`
entityGuids	Lista	Opcional. GUIDs de entidade para filtrar.	`["MTIzNDU2..."]`
entityTypes	Lista	Opcional. Tipos de entidade para filtrar.	`["APPLICATION"]`
conditionIds	Lista	Opcional. IDs da condição do alerta para filtrar. Deve ser uma matriz JSON de inteiros.	`[10001, 10002]`
policyIds	Lista	Opcional. IDs de política de alertas para filtrar. Deve ser uma matriz JSON de inteiros.	`[5001]`
é reconhecido	Boleano	Opcional. Filtro de status de reconhecimento. `true` apenas para problemas reconhecidos. `false` apenas para problemas não reconhecidos.	`false`
isCorrelated	Boleano	Opcional. Indica se a inteligência aplicada da New Relic mesclou este problema com outros problemas relacionados para reduzir o ruído.	`false`
mutingStates	Lista	Opcional. Status de supressão de notificação. Um ou mais de `NOT_MUTED` , `FULLY_MUTED` ou `PARTIALLY_MUTED` .	`["NOT_MUTED"]`
contém	Corda	Opcional. Correspondência de texto livre, com distinção entre maiúsculas e minúsculas, nos principais atributos do problema.	`"checkout-service"`
startTime	Interno	Opcional. Início da janela de tempo, milissegundos epoch. Deve ser não negativo. Requer `endTime` — ambos os campos devem estar presentes para que o filtro de janela de tempo seja aplicado.	`1785900000000`
endTime	Interno	Opcional. Fim da janela de tempo, milissegundos epoch. Deve ser não negativo. Requer `startTime` — ambos os campos devem estar presentes para que o filtro de janela de tempo seja aplicado.	`1785998400000`
cursor	Corda	Opcional. Token de paginação opaco da saída `nextCursor` de uma chamada anterior. Recupera a próxima página de resultados.	`"eyJpZCI6IjE..."`
selectors	Lista	Opcional. Seletores JQ para extrair valores específicos da resposta.	`selectors: - name: issues expression: ".data.actor.account.aiIssues.issues.issues" - name: nextCursor expression: ".data.actor.account.aiIssues.issues.nextCursor"`

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

Saída	Tipo	Descrição
success	Boleano	`true` quando a etapa foi executada sem um erro de HTTP/transporte.
errorMessage	Corda	Contém uma mensagem de erro apenas quando a chamada falha no nível de HTTP/transporte. `null` em caso de sucesso.
dados	Mapa	Resposta do NerdGraph. Contém `data.actor.account.aiIssues.issues.issues` (matriz de objetos de issue) e `data.actor.account.aiIssues.issues.nextCursor` (`null` quando não existem mais páginas). O seguinte é um subconjunto representativo da resposta — cada issue carrega o conjunto completo de campos `AiIssuesIssue`: `issueId`, `title`, `description`, `priority`, `state`, `createdAt`, `updatedAt`, `closedAt`, `activatedAt`, `acknowledgedAt/By/ByChannel`, `closedBy/ByChannel`, `investigatedAt/By/ByChannel`, `unAcknowledgedAt/By/ByChannel`, `sources`, `origins`, `entityGuids/Names/Types`, `conditionName/FamilyId/Product`, `policyIds/Name`, `correlationRuleIds/Names/Descriptions`, `correlationStatus`, `correlatedBy`, `isCorrelated`, `isIdle`, `mutingState`, `totalIncidents`, `incidentIds`, `deepLinkUrl`, `accountIds`, `parentMergeId`, `mergeReason`, `eventType`, `wildcard`, `dataMlModules` (lista de pares de valor principal) e `realIssueCount`. Use `selectors` para extrair valores específicos. `{ "data": { "actor": { "account": { "aiIssues": { "issues": { "issues": [ { "issueId": "123e4567-e89b-12d3-a456-426614174000", "title": ["Example issue title"], "state": "ACTIVATED", "priority": "CRITICAL", "entityNames": ["example-entity"] } ], "nextCursor": null } } } } } }`

Saída

Tipo

Descrição

success

Boleano

true

quando a etapa foi executada sem um erro de HTTP/transporte.

errorMessage

Corda

Contém uma mensagem de erro apenas quando a chamada falha no nível de HTTP/transporte.

null

em caso de sucesso.

dados

Mapa

Resposta do NerdGraph. Contém data.actor.account.aiIssues.issues.issues (matriz de objetos de issue) e data.actor.account.aiIssues.issues.nextCursor (null quando não existem mais páginas). O seguinte é um subconjunto representativo da resposta — cada issue carrega o conjunto completo de campos AiIssuesIssue: issueId, title, description, priority, state, createdAt, updatedAt, closedAt, activatedAt, acknowledgedAt/By/ByChannel, closedBy/ByChannel, investigatedAt/By/ByChannel, unAcknowledgedAt/By/ByChannel, sources, origins, entityGuids/Names/Types, conditionName/FamilyId/Product, policyIds/Name, correlationRuleIds/Names/Descriptions, correlationStatus, correlatedBy, isCorrelated, isIdle, mutingState, totalIncidents, incidentIds, deepLinkUrl, accountIds, parentMergeId, mergeReason, eventType, wildcard, dataMlModules (lista de pares de valor principal) e realIssueCount. Use selectors para extrair valores específicos.

{
  "data": {
    "actor": {
      "account": {
        "aiIssues": {
          "issues": {
            "issues": [
              {
                "issueId": "123e4567-e89b-12d3-a456-426614174000",
                "title": ["Example issue title"],
                "state": "ACTIVATED",
                "priority": "CRITICAL",
                "entityNames": ["example-entity"]
              }
            ],
            "nextCursor": null
          }
        }
      }
    }
  }
}

Os exemplos a seguir mostram como usar essa ação com diferentes configurações de filtro.

Exemplo de fluxo de trabalho
Sem filtros — lista todos os problemas na conta, independentemente do estado, prioridade ou outros filtros. Apenas `accountId` é obrigatório: `name: newrelic_issue_list_all description: list all issues for an account with no filters steps: - name: newrelic_issue_list type: action action: newrelic.issue.list version: 1 inputs: accountId: 123456 next: end` O exemplo a seguir usa filtros básicos para listar problemas ativos e de alta prioridade para uma conta: `name: newrelic_issue_list_workflow description: list newrelic issues steps: - name: newrelic_issue_list type: action action: newrelic.issue.list version: 1 inputs: accountId: 123456 states: ["ACTIVATED", "CREATED"] priority: ["CRITICAL", "HIGH"] next: end` O exemplo a seguir usa múltiplos filtros para problemas críticos, não silenciados e não reconhecidos dentro de uma janela de tempo específica, com seletores achatando a resposta para paginação: name: newrelic_issue_list_advanced description: list unacknowledged critical issues in a time window steps: - name: newrelic_issue_list type: action action: newrelic.issue.list version: 1 inputs: accountId: 123456 states: ["ACTIVATED"] priority: ["CRITICAL"] isAcknowledged: false mutingStates: ["NOT_MUTED"] startTime: 1785900000000 endTime: 1785998400000 selectors: - name: issues expression: ".data.actor.account.aiIssues.issues.issues" - name: nextCursor expression: ".data.actor.account.aiIssues.issues.nextCursor" next: end Para percorrer os resultados adicionais do terceiro exemplo, utilize a saída `nextCursor` e passe-a novamente como a entrada `cursor` em uma chamada subsequente.

Exemplo de fluxo de trabalho

Sem filtros — lista todos os problemas na conta, independentemente do estado, prioridade ou outros filtros. Apenas accountId é obrigatório:

name: newrelic_issue_list_all
description: list all issues for an account with no filters
steps:
  - name: newrelic_issue_list
    type: action
    action: newrelic.issue.list
    version: 1
    inputs:
      accountId: 123456
    next: end

O exemplo a seguir usa filtros básicos para listar problemas ativos e de alta prioridade para uma conta:

name: newrelic_issue_list_workflow
description: list newrelic issues
steps:
  - name: newrelic_issue_list
    type: action
    action: newrelic.issue.list
    version: 1
    inputs:
      accountId: 123456
      states: ["ACTIVATED", "CREATED"]
      priority: ["CRITICAL", "HIGH"]
    next: end

O exemplo a seguir usa múltiplos filtros para problemas críticos, não silenciados e não reconhecidos dentro de uma janela de tempo específica, com seletores achatando a resposta para paginação:

name: newrelic_issue_list_advanced
description: list unacknowledged critical issues in a time window
steps:
  - name: newrelic_issue_list
    type: action
    action: newrelic.issue.list
    version: 1
    inputs:
      accountId: 123456
      states: ["ACTIVATED"]
      priority: ["CRITICAL"]
      isAcknowledged: false
      mutingStates: ["NOT_MUTED"]
      startTime: 1785900000000
      endTime: 1785998400000
      selectors:
        - name: issues
          expression: ".data.actor.account.aiIssues.issues.issues"
        - name: nextCursor
          expression: ".data.actor.account.aiIssues.issues.nextCursor"
    next: end

Para percorrer os resultados adicionais do terceiro exemplo, utilize a saída nextCursor e passe-a novamente como a entrada cursor em uma chamada subsequente.

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

Listar problemas.css-21sua1{background:none;border:none;width:0;padding:0;}

Listar problemas