Tutorial Nerdgraph: API de consulta de problemas e incidentes

Esta página é um lugar para você e sua equipe aprenderem como consultar seus dados em busca de problemas e incidentes e então configurar recursos usando nossa API NerdGraph.

Nossos dois principais tipos de dados são Issue Type e Incident Type.

Tipo de problema

Você pode aprender mais sobre os tipos de dados do New Relic aqui:

Nome	Tipo	Descrição
IDs da conta	[Int!]!	Uma lista de IDs de conta. Como um problema pode estar correlacionado com outros de outras contas.
acknowledgedAt	EpochMilliseconds	A hora em que o problema foi reconhecido.
acknowledgedBy	Corda	O usuário que reconheceu o problema.
activatedAt	EpochMilliseconds	A hora em que o problema foi ativado: createAt + gracePeriod.
closedAt	EpochMilliseconds	A hora em que o problema foi encerrado.
closedBy	Corda	O usuário que fechou o problema manualmente.
createdAt	EpochMilliseconds	A hora em que o problema foi criado.
descrição	[String!]!	Uma lista de descrições de incidentes.
entityGuids	[EntityGuid!]	Uma lista de identificadores de entidade exclusivos.
entityNames	[String!]	Uma lista de nomes de entidades.
entityTypes	[String!]	Uma lista de tipos de entidade.
ID do ambiente	[Int!]!	Consulte a visão geral da inteligência aplicada para aprender sobre os ambientes.
eventType	Corda!	Um evento de problema que pode ser `INCIDENT_ADDED`, `USER_ACTION`, `INCIDENT_CLOSED`, etc.
incidentIds	[String!]	Uma lista de IDs de incidentes nesta edição. Em alguns casos, pode haver milhares de incidentes em um problema.
isCorrelated	Boleano!	Verdadeiro significa que outras questões foram correlacionadas a esta.
isIdle	Boleano!	Consulte nossa documentação para saber mais sobre problemas de inatividade.
issueId	EU IA!	Identificador de problemas.
origens	[String!]!	Uma lista de origens de incidentes como incidente, anomalia e externa.
prioridade	Prioridade!	A prioridade do problema. Pode ser um dos seguintes: `LOW`, `MEDIUM`, `HIGH`, `CRITICAL`.
fontes	[String!]!	Uma lista de fontes do incidente como newrelic ou externa.
estado	Estado da questão!	O estado do problema pode ser um dos seguintes: `CREATED`, `ACTIVATED`, `DEACTIVATED`, `CLOSED`.
título	[String!]!	Uma lista de títulos de incidentes subjacentes.
totalIncidents	Int!	A contagem do incidente subjacente.
updatedAt	EpochMilliseconds!	A hora em que o problema foi atualizado pela última vez.

Ciclo de vida e estado do problema

Problemas de inatividade:

Um problema pode ficar ocioso se for muito grande, o que significa que contém 5.000 incidentes ou mais.
Uma questão ociosa não aceita mais nenhum incidente.
Um problema de inatividade não se correlacionará com outros problemas.

Tipo de incidente

Campo	Tipo	Descrição
IDs da conta	Corda	Um ID de conta em que este incidente está armazenado.
closedAt	EpochMilliseconds	A hora em que o incidente foi encerrado.
createdAt	EpochMilliseconds	A hora em que o incidente foi criado.
descrição	Corda	A descrição é gerada a partir do nome da política e do nome da condição ou fornecida por meio da API.
entityGuids	EntityGuid	Um identificador de entidade exclusivo.
entityNames	Corda	Um nome de entidade.
entityTypes	Corda	Um tipo de entidade.
ID do ambiente	Int!	Consulte nossa documentação para aprender sobre ambientes.
ID de incidente	EU IA	Identificador de incidentes.
prioridade	Prioridade	Prioridade do incidente. Pode ser um dos seguintes: `LOW`, `MEDIUM`, `HIGH`, `CRITICAL`.
estado	Estado do Incidente.	Estado do incidente. Pode ser um dos seguintes:`CREATED`, `CLOSED`.
Timestamp	EpochMilliseconds	Timestamp do evento de incidente.
título	Corda	A descrição que o usuário forneceu à condição, se fornecida.
updatedAt	EpochMilliseconds	A hora em que o incidente foi atualizado pela última vez.
anomaliaId	Opcional	Se este incidente tiver origem em uma anomalia da New Relic, ele terá um ID de anomalia.
conditionFamilyId	Opcional	O ID da condição
policyIds	Corda	O ID da política que gerou este incidente.
aggregationTags	[KeyValue!]	Agregação de tags relacionadas a este incidente.

Listar e filtrar problemas

A consulta issues permite paginar todos os seus problemas por conta. Também permite algumas funcionalidades de filtragem sobre os problemas.

Se você não fornecer dados de filtragem, receberá os dados do problema das últimas 24 horas.

Solicitar

{
  currentUser {
    account(id: ACCOUNT_ID) {
      aiIssues {
        issues {
          issues {
            issueId
            priority
            state
            title
          }
        }
      }
    }
  }
}

Resultados

{
  "data": {
    "currentUser": {
      "account": {
        "aiIssues": {
          "issues": {
            "issues": [
              {
                "issueId": "f0668430-60c4-4bfd-8188-fcbeefb1d5ca",
                "priority": "CRITICAL",
                "state": "CREATED",
                "title": [
                  "NrAiIncident query result is > 30.0 for 1 minutes on 'ROI test for photon with checkbox'"
                ]
              },
              {
                "issueId": "12427573-fe89-4be1-9411-30158e0a9874",
                "priority": "MEDIUM",
                "state": "CLOSED",
                "title": [
                  "Anomaly: It was different from normal"
                ]
              },
              {
                "issueId": "2b3fcffe-5330-4766-bc51-392b6db5eedc",
                "priority": "MEDIUM",
                "state": "CLOSED",
                "title": [
                  "Anomaly: It was different from normal"
                ]
              },

Observe que o número máximo de problemas que podem ser retornados por meio da paginação é definido pelo NRQL LIMIT MAX e a filtragem será necessária caso esse limite seja excedido.

Solicitação Inicial

{
  currentUser {
    account(id: YOUR_ACCOUNT_ID) {
      aiIssues {
        issues(cursor: "") {
          issues {
            issueId
            priority
            state
            title
          }
          nextCursor
        }
      }
    }
  }
}

Resultados iniciais

{
  "data": {
    "currentUser": {
      "account": {
        "aiIssues": {
          "issues": {
            "issues": [
              {
                "issueId": "bda33b52-c70b-47b9-abe3-9e859a394037",
                "priority": "CRITICAL",
                "state": "ACTIVATED",
                "title": [
                  "Signal lost for 5 minutes on 'Percent All Facet'"
                ]
              },
              {
                "issueId": "242c713c-7654-491c-808e-3aa7fc44812b",
                "priority": "MEDIUM",
                "state": "CREATED",
                "title": [
                  "Anomaly: Non-web throughput"
                ]
              },


              {
                "issueId": "f19c9803-fb24-4d5d-9c35-16f659bceb3a",
                "priority": "MEDIUM",
                "state": "CLOSED",
                "title": [
                  "Anomaly: Error rate"
                ]
              }
            ],
            "nextCursor": "=ATN"
          }
        }
      }
    }
  },

Em seguida, na solicitação subsequente, forneça o valor do cursor da nextCursor resposta anterior, até que nextCursor esteja vazio.

A solicitação subsequente deve ser semelhante a:

{
  currentUser {
    account(id: YOUR_ACCOUNT_ID) {
      aiIssues {
        issues(cursor: "=ATN") {
          issues {
            issueId
            priority
            state
            title
          }
          nextCursor
        }
      }
    }
  }
}

Filtre os problemas por guias de entidade, tipos de entidade, prioridade de problemas ou estados de problemas ou qualquer combinação desses atributos.

"Filter issues"
input FilterIssues {
  "entityGuids"
  entityGuids: [EntityGuid!]
  "entityTypes"
  entityTypes: [String!]
  "ids"
  ids: [ID!]
  "priority"
  priority: [String!]
  "states"
  states: [IssueState!]
}

Aqui entityGuides e entityTypes são atributo de entidade definido na página Saiba mais sobre as entidades da New Relic .

A prioridade do problema pode ser uma das seguintes: LOW, MEDIUM, HIGH, CRITICAL
Os estados do problema podem ser um dos seguintes: CREATED, ACTIVATED, DEACTIVATED, CLOSED
timeWindow com horários de início e término no formato EpochMilliseconds. Se não for fornecido, o valor padrão será as últimas 24 horas
E cursor como já vimos

Vamos encontrar problemas com prioridade CRITICAL e estado CLOSED:

{
  currentUser {
    account(id: YOUR_ACCOUNT_ID) {
      aiIssues {
        issues(filter: { priority: "CRITICAL", states: CLOSED }) {
          issues {
            issueId
            priority
            state
            title
          }
          nextCursor
        }
      }
    }
  }
}

Resultados

{
  "data": {
    "currentUser": {
      "account": {
        "aiIssues": {
          "issues": {
            "issues": [
              {
                "issueId": "5948472b-f7dd-4a6e-aec0-de0390732495",
                "priority": "CRITICAL",
                "state": "CLOSED",
                "title": [
                  "team_store_validation_error query result is > 0.0 on 'Team Store Domain Specific Validation Error'"
                ]
              },
              {
                "issueId": "570c2770-efd2-4c0f-8dc8-fbc1ae69a4df",
                "priority": "CRITICAL",
                "state": "CLOSED",
                "title": [
                  "PageViewTiming query deviated from the baseline at least once in 5 minutes on 'Onyx_check_Mark test'"
                ]
              },
              {
                "issueId": "d056be64-829e-4a83-bfb1-e3232eb3a59b",
                "priority": "CRITICAL",
                "state": "CLOSED",
                "title": [
                  "Transaction query result is > 2.0 on 'Error fetching commitments (TF)'"
                ]
              },

Os resultados podem ser filtrados ainda mais por entityGuid.

{
  actor {
    account(id: 1) {
      aiIssues {
        issues(
          filter: {
            priority: "CRITICAL"
            states: CLOSED
            entityGuids: [
              "MXxBUE18QVBQTElDQVRJT058MzIxNjY2NA"
              "MXxBUE18QVBQTElDQVRJT058MzIxNzY1NA"
            ]
          }
        ) {
          issues {
            entityTypes
            entityNames
            entityGuids
            issueId
            priority
            state
            title
          }
          nextCursor
        }
      }
    }
  }
}

Resultados

{
  "data": {
    "actor": {
      "account": {
        "aiIssues": {
          "issues": {
            "issues": [
              {
                "entityGuids": [
                  "MXxBUE18QVBQTElDQVRJT058MzIxNjY2NA",
                  "MXxBUE18QVBQTElDQVRJT058MzIxNzY1NA"
                ],
                "entityNames": [
                  "hour-timeslice-writer (eu-production)",
                  "metric-timeslice-service (eu-production)"
                ],
                "entityTypes": [
                  "Application"
                ],
                "issueId": "1a3a0581-aefc-4027-91a0-a941072101c0",
                "priority": "CRITICAL",
                "state": "CLOSED",
                "title": [
                  "'Custom/CassandraClient/hour_timeslice_cluster_main/percentile/95th' > 0.5 for at least 5 minutes on 'hour-timeslice-writer (eu-production)'",
                  "'Custom/CassandraClient/hour_timeslice_cluster_main/percentile/95th' > 0.5 for at least 5 minutes on 'metric-timeslice-service (eu-production)'"
                ]
              },
              {
                "entityGuids": [
                  "MXxBUE18QVBQTElDQVRJT058MzIxNzY1NA"
                ],
                "entityNames": [
                  "metric-timeslice-service (eu-production)"
                ],
                "entityTypes": [
                  "Application"
                ],
                "issueId": "fd5fda9e-6bfe-469a-8cf7-822986401033",
                "priority": "CRITICAL",
                "state": "CLOSED",
                "title": [
                  "'Custom/CassandraClient/hour_timeslice_cluster_main/percentile/95th' > 0.5 for at least 5 minutes on 'metric-timeslice-service (eu-production)'"
                ]
              }
            ],
            "nextCursor": null
          }

O NerdGraph também permite consultar por ID do problema.

Solicitar

{
  actor {
    account(id: 1) {
      aiIssues {
        issues(
          filter: {
            ids: [
              "e506476f-d804-4e5c-92b5-da8db622f10d"
              "1bd514d9-2682-4366-8f28-5d742fd000af"
            ]
          }
        ) {
          issues {
            entityTypes
            entityNames
            entityGuids
            issueId
            priority
            state
            title
          }
          nextCursor
        }
      }
    }
  }
}

Resultados

{
  "data": {
    "actor": {
      "account": {
        "aiIssues": {
          "issues": {
            "issues": [
              {
                "entityGuids": [
                  ""
                ],
                "entityNames": [
                  "Metric query"
                ],
                "entityTypes": [
                  "Query"
                ],
                "issueId": "e506476f-d804-4e5c-92b5-da8db622f10d",
                "priority": "CRITICAL",
                "state": "CLOSED",
                "title": [
                  "Metric query result is > 1.4 for 1 minutes on 'Hillel March Demo'"
                ]
              },
              {
                "entityGuids": [
                  "MXxFWFR8U0VSVklDRXw1ODIzMTc1ODk4Mjc1OTI4Mjk5"
                ],
                "entityNames": [
                  "clm-10"
                ],
                "entityTypes": [
                  "Query"
                ],
                "issueId": "1bd514d9-2682-4366-8f28-5d742fd000af",
                "priority": "CRITICAL",
                "state": "CLOSED",
                "title": [
                  "clm-10 query result is > 30.0 for 7 minutes on 'SPIKE: signal-accumulation-service (production) — Kafka lag'"
                ]
              }
            ],
            "nextCursor": null
          }
        }

Listar e filtrar evento de problema

A consulta issuesEvents permite paginar todos os seus problemas por conta. Também permite alguma funcionalidade de filtragem no evento de problemas.

Se você não fornecer nenhum dado de filtragem, receberá os dados do evento de problema das últimas 24 horas.

Solicitar

{
  currentUser {
    account(id: YOUR_ACCOUNT_ID) {
      aiIssues {
        issuesEvents {
          issues {
            issueId
            priority
            state
            title
            eventType
          }
        }
      }
    }
  }
}

Resultados

{
  "data": {
    "currentUser": {
      "account": {
        "aiIssues": {
          "issuesEvents": {
            "issues": [
              {
                "eventType": "ATTRIBUTES_UPDATED",
                "issueId": "e6da1499-cb1c-4522-bb04-6fdb487e8e2b",
                "priority": "CRITICAL",
                "state": "ACTIVATED",
                "title": [
                  "notification-request-builder query result is < 10.0 for 1 minutes on 'error logs in nrb'",
                  "notification-request-builder query result is > 1600.0 for 5 minutes on 'nrb debug logs'"
                ]
              },
              {
                "eventType": "ATTRIBUTES_UPDATED",
                "issueId": "e6da1499-cb1c-4522-bb04-6fdb487e8e2b",
                "priority": "CRITICAL",
                "state": "ACTIVATED",
                "title": [
                  "notification-request-builder query result is < 10.0 for 1 minutes on 'error logs in nrb'",
                  "notification-request-builder query result is > 1600.0 for 5 minutes on 'nrb debug logs'"
                ]
              },
              {
                "eventType": "ATTRIBUTES_UPDATED",
                "issueId": "e6da1499-cb1c-4522-bb04-6fdb487e8e2b",
                "priority": "CRITICAL",
                "state": "ACTIVATED",
                "title": [
                  "notification-request-builder query result is < 10.0 for 1 minutes on 'error logs in nrb'",
                  "notification-request-builder query result is > 1600.0 for 5 minutes on 'nrb debug logs'"
                ]
              },
              {
                "eventType": "INCIDENT_ADDED",
                "issueId": "e6da1499-cb1c-4522-bb04-6fdb487e8e2b",
                "priority": "CRITICAL",
                "state": "ACTIVATED",
                "title": [
                  "notification-request-builder query result is < 10.0 for 1 minutes on 'error logs in nrb'",
                  "notification-request-builder query result is > 1600.0 for 5 minutes on 'nrb debug logs'"
                ]
              },

Filtre o evento do problema por entityGuids, entityTypes, prioridade dos problemas ou estados do problema ou qualquer combinação desses atributos.

"Filter issues events"
input FilterIssuesEvents {
  "entityGuids"
  entityGuids: [EntityGuid!]
  "entityTypes"
  entityTypes: [String!]
  "ids"
  ids: [ID!]
}

timeWindow com horários de início e término no formato EpochMilliseconds . Se não for fornecido, o valor padrão será as últimas 24 horas
E cursor como já vimos

Vamos encontrar issuesEvents para um issueId específico.

{
  currentUser {
    account(id: YOUR_ACCOUNT_ID) {
      aiIssues {
        issuesEvents(filter: { ids: "fe0d512f-36c7-4b7a-8a80-4c47c040807a" }) {
          issues {
            issueId
            priority
            state
            title
            eventType
            entityGuids
          }
        }
      }
    }
  }
}

Results

{
  "data": {
    "currentUser": {
      "account": {
        "aiIssues": {
          "issuesEvents": {
            "issues": [
              {
                "entityGuids": [
                  "MXxTWU5USHxNT05JVE9SfGUyMzA0MjczLTQzNjUtNDRlZS1iODcxLTM5MGRhNDc1ODUxNA"
                ],
                "eventType": "ATTRIBUTES_UPDATED",
                "issueId": "fe0d512f-36c7-4b7a-8a80-4c47c040807a",
                "priority": "CRITICAL",
                "state": "ACTIVATED",
                "title": [
                  "Test for alert emails query result is > 1.0 for 1 minutes on 'Matan email condition'"
                ]
              },
              {
                "entityGuids": [
                  "MXxTWU5USHxNT05JVE9SfGUyMzA0MjczLTQzNjUtNDRlZS1iODcxLTM5MGRhNDc1ODUxNA"
                ],
                "eventType": "STATE_CHANGE",
                "issueId": "fe0d512f-36c7-4b7a-8a80-4c47c040807a",
                "priority": "CRITICAL",
                "state": "ACTIVATED",
                "title": [
                  "Test for alert emails query result is > 1.0 for 1 minutes on 'Matan email condition'"
                ]
              },
              {
                "entityGuids": [
                  "MXxTWU5USHxNT05JVE9SfGUyMzA0MjczLTQzNjUtNDRlZS1iODcxLTM5MGRhNDc1ODUxNA"
                ],
                "eventType": "ATTRIBUTES_UPDATED",
                "issueId": "fe0d512f-36c7-4b7a-8a80-4c47c040807a",
                "priority": "CRITICAL",
                "state": "CREATED",
                "title": [
                  "Test for alert emails query result is > 1.0 for 1 minutes on 'Matan email condition'"
                ]
              },
              {
                "entityGuids": [
                  "MXxTWU5USHxNT05JVE9SfGUyMzA0MjczLTQzNjUtNDRlZS1iODcxLTM5MGRhNDc1ODUxNA"
                ],
                "eventType": "ATTRIBUTES_UPDATED",
                "issueId": "fe0d512f-36c7-4b7a-8a80-4c47c040807a",
                "priority": "CRITICAL",
                "state": "CREATED",
                "title": [
                  "Test for alert emails query result is > 1.0 for 1 minutes on 'Matan email condition'"
                ]
              },
...

Listar e filtrar incidentes

A consulta incidents permite paginar todos os seus incidentes por conta. Também permite alguma funcionalidade de filtragem em cada incidente.

Os seguintes tipos de incidente são suportados:

NewRelicIncident
AnomalyIncident
RestIncident

Se você não fornecer nenhum dado de filtragem, receberá os dados do incidente das últimas 24 horas.

O exemplo abaixo busca NewRelicIncident incidente:

Solicitações de

{
  currentUser {
    account(id: YOUR_ACCOUNT_ID) {
      aiIssues {
        incidents {
          incidents {
            priority
            state
            title
            description
            incidentId
            updatedAt
            ... on AiIssuesNewRelicIncident {
              policyIds
              conditionFamilyId
              accountIds
            }
          }
        }
      }
    }
  }
}

Resultados

{
  "data": {
    "currentUser": {
      "account": {
        "aiIssues": {
          "incidents": {
            "incidents": [
              {
                "accountIds": "1",
                "conditionFamilyId": "685305",
                "description": [
                  "Policy: 'Roi nov Test'. Condition: 'RB PV '"
                ],
                "incidentId": "a86493e4-2d25-4023-a9e5-975bfaae19a8",
                "policyIds": "195617",
                "priority": "HIGH",
                "state": "CREATED",
                "title": "[\"PageView query result is > 1.3 for 2 minutes on 'RB PV '\"]",
                "updatedAt": 1651058532782
              },
              {
                "accountIds": "1",
                "conditionFamilyId": "1284850",
                "description": [
                  "Policy: 'Itzik first policy'. Condition: 'error logs in nrb'"
                ],
                "incidentId": "5de80214-6444-4e0c-aaee-fb1c42fb2f23",
                "policyIds": "707052",
                "priority": "CRITICAL",
                "state": "CREATED",
                "title": "[\"notification-request-builder query result is < 10.0 for 1 minutes on 'error logs in nrb'\"]",
                "updatedAt": 1651058523473
              },
              {
                "description": [
                  "Anomaly: Error rate"
                ],
                "incidentId": "df4ba4f3-9463-4389-873f-b13efb67dca5",
                "priority": "MEDIUM",
                "state": "CREATED",
                "title": "[\"Anomaly: Error rate\"]",
                "updatedAt": 1651058478828
              },
              {
                "accountIds": "1",
                "conditionFamilyId": "685305",
                "description": [
                  "Policy: 'Roi nov Test'. Condition: 'RB PV '"
                ],
                "incidentId": "0063f153-9152-476d-b435-54cc38ce0245",
                "policyIds": "195617",
                "priority": "CRITICAL",
                "state": "CREATED",
                "title": "[\"PageView query result is > 1.3 on 'RB PV '\"]",
                "updatedAt": 1651058472738
              },
              {
                "description": [
                  "Anomaly: It was different from normal"
                ],
                "incidentId": "2cb820d1-a070-4c27-860b-fb862ecd42a7",
                "priority": "MEDIUM",
                "state": "CREATED",
                "title": "[\"Anomaly: It was different from normal\"]",
                "updatedAt": 1651058449078
              },
              {
                "accountIds": "1",
                "conditionFamilyId": "751197",
                "description": [
                  "Policy: 'slide_Test'. Condition: 'SumOf'"
                ],
                "incidentId": "07104b47-0263-4529-b27d-6aff95eecd87",
                "policyIds": "199127",
                "priority": "CRITICAL",
                "state": "CREATED",
                "title": "[\"TransactionError query result is > 3.0 on 'SumOf'\"]",
                "updatedAt": 1651058442361
              },

Paginação do cursor

Observe que o número máximo de incidentes que podem ser retornados através da paginação é definido pelo NRQL LIMIT MAX, e a filtragem será necessária caso esse limite seja excedido.

Filtrar incidente

Filtre por guias de entidade, tipos de entidade, prioridade de problemas ou estados de problemas ou qualquer combinação deles.

"Filter incidents"
input FilterIncidents {
  "entityGuids"
  entityGuids: [EntityGuid!]
  "entityTypes"
  entityTypes: [String!]
  "ids"
  ids: [ID!]
  "priority"
  priority: [String!]
  "states"
  states: [IncidentState!]
}

timeWindow com horários de início e término no formato EpochMilliseconds . Se não for fornecido, o valor padrão será as últimas 24 horas.
E cursor como já vimos.
Vamos encontrar o incidente com prioridade CRITICAL e estado CREATED.

{
  currentUser {
    account(id: YOUR_ACCOUNT_ID) {
      aiIssues {
        incidents(filter: { priority: "CRITICAL", states: CREATED }) {
          incidents {
            priority
            state
            title
            description
            incidentId
            updatedAt
            ... on AiIssuesNewRelicIncident {
              policyIds
              conditionFamilyId
              accountIds
            }
          }
        }
      }
    }
  }
}

Resultados

{
  "data": {
    "currentUser": {
      "account": {
        "aiIssues": {
          "incidents": {
            "incidents": [
              {
                "accountIds": "1",
                "conditionFamilyId": "195908",
                "description": [
                  "Policy: 'AirMonitor ML Dashboard Staging'. Condition: 'Latency in Production'"
                ],
                "incidentId": "44630d21-9d32-4107-a308-3ed1c4f72bce",
                "policyIds": "40053",
                "priority": "CRITICAL",
                "state": "CREATED",
                "title": "[\"Metric query result is > 0.69 for 5 minutes on 'Latency in Production'\"]",
                "updatedAt": 1651059983674
              },
              {
                "accountIds": "1",
                "conditionFamilyId": "195908",
                "description": [
                  "Policy: 'AirMonitor ML Dashboard Staging'. Condition: 'Latency in Production'"
                ],
                "incidentId": "3e2b2b2a-e45b-46d6-b45d-637b74b5efda",
                "policyIds": "40053",
                "priority": "CRITICAL",
                "state": "CREATED",
                "title": "[\"Metric query result is > 0.69 for 5 minutes on 'Latency in Production'\"]",
                "updatedAt": 1651059983607
              },
              {
                "accountIds": "1",
                "conditionFamilyId": "195907",
                "description": [
                  "Policy: 'AirMonitor ML Dashboard Staging'. Condition: 'Latency in Staging'"
                ],
                "incidentId": "6e934358-d16b-494d-abb2-6300c4d96f11",
                "policyIds": "40053",
                "priority": "CRITICAL",
                "state": "CREATED",
                "title": "[\"Metric query result is > 0.69 for 5 minutes on 'Latency in Staging'\"]",
                "updatedAt": 1651059983223
              },
              {
                "accountIds": "1",
                "conditionFamilyId": "195907",
                "description": [
                  "Policy: 'AirMonitor ML Dashboard Staging'. Condition: 'Latency in Staging'"
                ],
                "incidentId": "97373770-caad-46cd-a69d-a358de3be090",
                "policyIds": "40053",
                "priority": "CRITICAL",
                "state": "CREATED",
                "title": "[\"Metric query result is > 0.69 for 5 minutes on 'Latency in Staging'\"]",
                "updatedAt": 1651059983059
              },

A API permite consultar por ID de incidente:

Solicitar

{
  currentUser {
    account(id: YOUR_ACCOUNT_ID) {
      aiIssues {
        incidents(filter: { ids: "97373770-caad-46cd-a69d-a358de3be090" }) {
          incidents {
            priority
            state
            title
            description
            incidentId
            updatedAt
            ... on AiIssuesNewRelicIncident {
              policyIds
              conditionFamilyId
              accountIds
            }
          }
        }
      }
    }
  }
}

Resultado

{
  "data": {
    "currentUser": {
      "account": {
        "aiIssues": {
          "incidents": {
            "incidents": [
              {
                "accountIds": "1",
                "conditionFamilyId": "195907",
                "description": [
                  "Policy: 'AirMonitor ML Dashboard Staging'. Condition: 'Latency in Staging'"
                ],
                "incidentId": "97373770-caad-46cd-a69d-a358de3be090",
                "policyIds": "40053",
                "priority": "CRITICAL",
                "state": "CREATED",
                "title": "[\"Metric query result is > 0.69 for 5 minutes on 'Latency in Staging'\"]",
                "updatedAt": 1651059983059
              }
            ]
          }
        }
      }
    }
  },

Listar e filtrar evento de incidente

A consulta incidentsEvents permite paginar todos os seus eventos de incidente por conta. Também permite algumas funcionalidades de filtragem no evento de incidente.

Se você não fornecer nenhum dado de filtragem, você obterá os dados do evento incidente das últimas 24 horas.

Solicitar

{
  currentUser {
    account(id: YOUR_ACCOUNT_ID) {
      aiIssues {
        incidentsEvents {
          incidents {
            priority
            incidentId
            state
            title
            updatedAt
            description
          }
        }
      }
    }
  }
}

Resultados

{
  "data": {
    "currentUser": {
      "account": {
        "aiIssues": {
          "incidentsEvents": {
            "incidents": [
              {
                "description": [
                  "Policy: 'e2e: hrr9ISoLd'. Condition: 'e2e: VceqCmtcT'"
                ],
                "incidentId": "693b7dcb-5a6b-4923-acaa-9d4e7e568ae5",
                "priority": "CRITICAL",
                "state": "CLOSED",
                "title": "[\"Provider . Burst Balance . Average < 1 at least once in 2 minutes on 'vol-03e3199dd4b4ffac4'\"]",
                "updatedAt": 1651060591602
              },
              {
                "description": [
                  "Policy: 'e2e: hrr9ISoLd'. Condition: 'e2e: VceqCmtcT'"
                ],
                "incidentId": "fb0dcb8b-052f-4056-8579-ff7cae8fa879",
                "priority": "CRITICAL",
                "state": "CLOSED",
                "title": "[\"Provider . Burst Balance . Average < 1 at least once in 2 minutes on 'vol-00163b96c3ccd2199'\"]",
                "updatedAt": 1651060587005
              },
              {
                "description": [
                  "Policy: 'AirMonitor ML Dashboard Staging'. Condition: 'Latency in Staging'"
                ],
                "incidentId": "42bcd3e2-bc2d-4a3d-9e85-ebd8597e6eba",
                "priority": "CRITICAL",
                "state": "CLOSED",
                "title": "[\"Metric query result is > 0.69 for 5 minutes on 'Latency in Staging'\"]",
                "updatedAt": 1651060560312
              },

Paginação do cursor

Para paginar seus dados, você deve incluir o campo nextCursor em sua consulta inicial.

Filtrar evento de incidente

Filtre o evento por guias de entidade, tipos de entidade, prioridade do incidente ou estados do incidente ou qualquer combinação destes.

"Filter incidents events"
input FilterIncidentsEvents {
  "entityGuids"
  entityGuids: [EntityGuid!]
  "entityTypes"
  entityTypes: [String!]
  "ids"
  ids: [ID!]
}

timeWindow com horários de início e término no formato EpochMilliseconds . Se não for fornecido, o valor padrão será as últimas 24 horas.
E cursor como já vimos.

Vamos consultar o incidente do evento, para que possamos obter seus 'incidentId's:

{
  currentUser {
    account(id: YOUR_ACCOUNT_ID) {
      aiIssues {
        incidentsEvents(
          filter: { ids: "cd512082-6ebe-46ac-a6dc-d387dc86dc80" }
        ) {
          incidents {
            priority
            incidentId
            state
            title
            updatedAt
            description
            createdAt
            timestamp
            ... on AiIssuesNewRelicIncident {
              accountIds
              policyIds
            }
          }
        }
      }
    }
  }
}

Resultados

{
  "data": {
    "currentUser": {
      "account": {
        "aiIssues": {
          "incidentsEvents": {
            "incidents": [
              {
                "accountIds": "1",
                "createdAt": "1651060523109",
                "description": [
                  "Policy: 'KPT: Low-urgency'. Condition: 'Kafka broker offline'"
                ],
                "incidentId": "cd512082-6ebe-46ac-a6dc-d387dc86dc80",
                "policyIds": "80113",
                "priority": "CRITICAL",
                "state": "CREATED",
                "timestamp": 1651060523110,
                "title": "[\"Signal lost for 35 minutes on 'Kafka broker offline'\"]",
                "updatedAt": 1651060523110
              },
              {
                "accountIds": "1",
                "createdAt": "1651060523109",
                "description": [
                  "Policy: 'KPT: Low-urgency'. Condition: 'Kafka broker offline'"
                ],
                "incidentId": "cd512082-6ebe-46ac-a6dc-d387dc86dc80",
                "policyIds": "80113",
                "priority": "CRITICAL",
                "state": "CREATED",
                "timestamp": 1651060523110,
                "title": "[\"Signal lost for 35 minutes on 'Kafka broker offline'\"]",
                "updatedAt": 1651060523110
              },
              {
                "accountIds": "1",
                "createdAt": "1651060523109",
                "description": [
                  "Policy: 'KPT: Low-urgency'. Condition: 'Kafka broker offline'"
                ],

Configurar recurso de problemas

O serviço de problemas possui algum parâmetro de configuração.

Para obter o parâmetro de configuração atual para seu ambiente, você pode executar a consulta configByEnvironment .

Solicitar

{
  currentUser {
    account(id: YOUR_ACCOUNT_ID) {
      aiIssues {
        configByEnvironment {
          config {
            flappingInterval
            inactivePeriod
            incidentTimeout
            issueTtl
            maxIssueSize
          }
        }
      }
    }
  }
}

Resultados

{
  "data": {
    "currentUser": {
      "account": {
        "aiIssues": {
          "configByEnvironment": {
            "config": {
              "flappingInterval": 0,
              "gracePeriod": [
                {
                  "period": 60,
                  "priority": "CRITICAL"
                },
                {
                  "period": 300,
                  "priority": "HIGH"
                },
                {
                  "period": 600,
                  "priority": "MEDIUM"
                },
                {
                  "period": 900,
                  "priority": "LOW"
                }
              ],
              "inactivePeriod": 14400,
              "incidentTimeout": 90000,
              "issueTtl": 259200,
              "maxIssueSize": 5000
            }
          }
        }
      }
    }
  }

Aqui, cada configuração de ambiente possui o seguinte parâmetro:

"Environment configuration object"
type EnvironmentConfiguration {
  "Flapping interval in seconds"
  flappingInterval: Seconds
  "Grace periods per priority"
  gracePeriod: [GracePeriodConfig!]
  "Inactive period in seconds"
  inactivePeriod: Seconds
  "Incident timeout in seconds"
  incidentTimeout: Seconds
  "Issue TTL in seconds"
  issueTtl: Seconds
  "Max incidents in the issue"
  maxIssueSize: Int
}

Usando o mutations correspondente, você também pode alterar os parâmetros de configuração do ambiente issueTtl e gracePeriod .

aiIssuesUpdateIssueTtl
aiIssuesUpdateGracePeriod

Solicitar

mutation {
  aiIssuesUpdateIssueTtl(accountId: YOUR_ACCOUNT_ID, issueTtl: 259200) {
    error
    config {
      flappingInterval
      gracePeriod {
        period
        priority
      }
      inactivePeriod
      incidentTimeout
      issueTtl
      maxIssueSize
    }
  }
}

Resultados

{
  "data": {
    "aiIssuesUpdateIssueTtl": {
      "config": {
        "flappingInterval": 0,
        "gracePeriod": [
          {
            "period": 60,
            "priority": "CRITICAL"
          },
          {
            "period": 300,
            "priority": "HIGH"
          },
          {
            "period": 600,
            "priority": "MEDIUM"
          },
          {
            "period": 900,
            "priority": "LOW"
          }
        ],
        "inactivePeriod": 14400,
        "incidentTimeout": 90000,
        "issueTtl": 259200,
        "maxIssueSize": 5000
      },
      "error": null
    }
  },

Reconhecer ou não reconhecer problemas

Usando mutations você pode confirmar ou não e resolver o problema específico por meio de seu issueId.

aiIssuesAckIssue
aiIssuesResolveIssue
aiIssuesUnackIssue

Solicitar

mutation {
  aiIssuesResolveIssue(
    accountId: 10581561
    issueId: "f0846f5e-fc9d-4dc0-afdd-07cce7cc6fc4"
  ) {
    error
    result {
      action
      accountId
      issueId
      routingKey
    }
  }
}

Resultados

{
"data": {
    "aiIssuesResolveIssue": {
      "error": null,
      "result": {
        "accountId": 10581561,
        "action": "RESOLVE",
        "issueId": "f0846f5e-fc9d-4dc0-afdd-07cce7cc6fc4",
        "routingKey": "93538a443af520d10e7999fdb183ebf21e4cb6bd"
      }
    }

Executando a partir da linha de comando

Para executar a consulta na linha de comando:

1 Obtenha sua chave de API, busque ou crie uma na interface API Key.

2 Exporte-o para o seu shell com export API_KEY=my_api_key

3 Execute estes exemplos:

Importante

Você deve incluir um cabeçalho de aceitação experimental em suas solicitações. Caso contrário, você receberá erros de acesso como este:

{"data":{"actor":{"account":{"aiIssues":{"issues":null}}}},"errors":[{"extensions":{"errorClass":"ACCESS_DENIED","nrOnly":{}},"locations":[{"column":70,"line":1}],"message":"You must opt in to using experimental schemas by passing the 'nerd-graph-unsafe-experimental-opt-in: AiIssues' header.\n\nProviding the header indicates that you acknowlege that the field(s) you are querying are subject to breaking changes.\n","path":["actor","account","aiIssues","issues"]}]}%

Liste todos os problemas das últimas 24 horas

Como aparecem as solicitações na interface GraphQL

{
  currentUser {
    account(id: YOUR_ACCOUNT_ID) {
      aiIssues {
        issues {
          issues {
            issueId
            priority
            state
            title
          }
        }
      }
    }
  }
}

Na linha de comando a mesma solicitação

{
"data": {
    "aiIssuesResolveIssue": {
      "error": null,
      "result": {
        "accountId": 10581561,
        "action": "RESOLVE",
        "issueId": "f0846f5e-fc9d-4dc0-afdd-07cce7cc6fc4",
        "routingKey": "93538a443af520d10e7999fdb183ebf21e4cb6bd"
      }
    }

Resultados

{
  "data": {
    "actor": {
      "account": {
        "aiIssues": {
          "issues": {
            "issues": [
              {
                "issueId": "eb152a9f-def7-45bd-9b3f-34ec61ef8c82",
                "priority": "MEDIUM",
                "state": "CREATED",
                "title": [
                  "Anomaly: It was different from normal"
                ]
              },
              {
                "issueId": "9ae6a86a-582f-4102-8757-ee11c1a20dfc",
                "priority": "HIGH",
                "state": "CREATED",
                "title": [
                  "Web throughput < 50 for at least 5 minutes on 'error-group-control-plane (staging)'"
                ]
              },
              {
                "issueId": "e19aa2d0-2b12-4148-aedd-848577e9c4fc",
                "priority": "CRITICAL",
                "state": "CREATED",
                "title": [
                  "clm-10 query result is > 1.0 for 15 minutes on 'NO_CONSUMER'"
                ]
              },
              {
                "issueId": "9184ab3c-4e45-4bc9-b2a5-f78c23a13197",
                "priority": "MEDIUM",
                "state": "CREATED",
                "title": [
                  "Anomaly: It was different from normal"
                ]
              },
              {
                "issueId": "e2d05a25-2a7e-4b3c-b5bf-8a236f2a0360",
                "priority": "MEDIUM",
                "state": "CREATED",
                "title": [
                  "Anomaly: It was different from normal"
                ]
              },
              {
                "issueId": "b478bd0e-baa1-42ed-8911-d32249d45010",
                "priority": "CRITICAL",
                "state": "ACTIVATED",
                "title": [
                  "PageViewTiming query deviated from the baseline at least once in 5 minutes on 'Onyx_check_Mark test'"
                ]
              },
              {
                "issueId": "f672153a-262b-4405-85a7-874709ed21ff",
                "priority": "MEDIUM",
                "state": "CREATED",
                "title": [
                  "Anomaly: It was different from normal"
                ]
              },
              ...

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

Tutorial Nerdgraph: API de consulta de problemas e incidentes

Tipo de problema .css-21sua1{background:none;border:none;width:0;padding:0;}

Ciclo de vida e estado do problema

Tipo de incidente

Listar e filtrar problemas

Paginação do cursor

Problemas de filtro

Encontre problemas por ID

Listar e filtrar evento de problema

Listar evento de problemas

Evento de problema de filtro

Listar e filtrar incidentes

Listar incidente

Filtrar incidente

Encontre incidentes por ID do incidente

Listar e filtrar evento de incidente

Listar evento de incidente

Filtrar evento de incidente

Configurar recurso de problemas

Consulta ConfigByEnvironment

Reconhecer ou não reconhecer problemas

Reconhecer ou não reconhecer problemas

Executando a partir da linha de comando

Importante

Exemplo: liste todos os problemas

Tipo de problema