Tutoriel NerdGraph : de incident requêtes sur les problèmes et API

Cette page est un endroit où vous et votre équipe pouvez apprendre à interroger vos données sur les problèmes et les incidents, puis à configurer les fonctionnalités à l'aide de notre API NerdGraph.

Nos deux principaux types de données sont Issue Type et Incident Type.

Type de problème

Vous pouvez en apprendre plus sur les types de données de New Relic ici :

Nom	Type	Description
`accountIds`	[Int!]!	Une liste d'identifiants de compte. Ce problème pourrait être corrélé avec d’autres problèmes provenant d’autres comptes.
`acknowledgedAt`	ÉpoqueMillisecondes	Le moment où le problème a été reconnu.
`acknowledgedBy`	Chaîne	L'utilisateur qui a reconnu le problème.
`activatedAt`	ÉpoqueMillisecondes	L'heure à laquelle le problème a été activé : createdAt + gracePeriod.
`closedAt`	ÉpoqueMillisecondes	L'heure à laquelle le problème a été clos.
`closedBy`	Chaîne	L'utilisateur qui a fermé manuellement le problème.
`createdAt`	ÉpoqueMillisecondes	L'heure à laquelle le problème a été créé.
`description`	[String!]!	Une liste de descriptions incident .
`entityGuids`	[EntityGuid!]	Une liste d'identifiants d'entité uniques.
`entityNames`	[String!]	Une liste de noms d’entités.
`entityTypes`	[String!]	Une liste de types d’entités.
`environmentId`	[Int!]!	Consultez l'aperçu des alertes pour en savoir plus sur les environnements.
`eventType`	Chaîne!	Un événement de problème qui pourrait être `INCIDENT_ADDED`, `USER_ACTION`, `INCIDENT_CLOSED`, etc.
`incidentIds`	[String!]	Une liste des identifiants d’incident dans ce problème. Dans certains cas, il peut y avoir des milliers d’incidents dans un problème.
`isCorrelated`	Booléen !	Vrai signifie que d’autres problèmes étaient liés à celui-ci.
`isIdle`	Booléen !	Consultez notre documentation pour en savoir plus sur les problèmes d'inactivité.
`issueId`	IDENTIFIANT!	Identifiant de l'émission.
`origins`	[String!]!	Une liste des origines d'un incident comme un incident, une anomalie et un incident externe.
`priority`	Priorité!	La priorité du problème. Peut être l’un des suivants : `LOW`, `MEDIUM`, `HIGH`, `CRITICAL`.
`sources`	[String!]!	Une liste des sources de l'incident comme newrelic ou externe.
`state`	État du problème !	L'état du problème peut être l'un des suivants : `CREATED`, `ACTIVATED`, `DEACTIVATED`, `CLOSED`.
`title`	[String!]!	Une liste de titres incident sous-jacents.
`totalIncidents`	Int!	Le nombre d’incidents sous-jacents.
`updatedAt`	ÉpoqueMillisecondes!	L'heure à laquelle le problème a été mis à jour pour la dernière fois.

Cycle de vie et état du problème

Problèmes de ralenti :

Un problème peut devenir inactif s'il est trop important, c'est-à-dire s'il contient 5 000 incidents ou plus.
Une question inactive n'accepte plus aucun incident.
Un problème d’inactivité ne sera pas lié à d’autres problèmes.

Type d'incident

Champ	Type	Description
`accountIds`	Chaîne	Un identifiant de compte dans lequel cet incident est stocké.
`closedAt`	ÉpoqueMillisecondes	L'heure à laquelle l'incident a été clos.
`createdAt`	ÉpoqueMillisecondes	L'heure à laquelle l'incident a été créé.
`description`	Chaîne	La description est générée à partir du nom de la politique et du nom de la condition ou fournie via l'API.
`entityGuids`	EntityGuid	Un identifiant d'entité unique.
`entityNames`	Chaîne	Un nom d'entité.
`entityTypes`	Chaîne	Un type d'entité.
`environmentId`	Int!	Consultez notre documentation pour en savoir plus sur les environnements.
`incidentId`	IDENTIFIANT	identifiant de l'incident.
`priority`	Priorité	Priorité de l'incident. Peut être l’un des suivants : `LOW`, `MEDIUM`, `HIGH`, `CRITICAL`.
`state`	État de l'incident.	État d'incident. Peut être l’un des suivants :`CREATED`, `CLOSED`.
`timestamp`	ÉpoqueMillisecondes	incident événement horodatage.
`title`	Chaîne	La description donnée par l'utilisateur à la condition si elle est fournie.
`updatedAt`	ÉpoqueMillisecondes	L'heure à laquelle l'incident a été mis à jour pour la dernière fois.
`anomalyId`	Facultatif	Si cet incident provient d'une anomalie New Relic, il aura un ID d'anomalie.
`conditionFamilyId`	Facultatif	L'identifiant de condition
`policyIds`	Chaîne	L'identifiant de la politique qui a généré cet incident.
`aggregationTags`	[KeyValue!]	Agrégation de tags liés à cet incident.

Lister et filtrer les problèmes

La requête issues vous permet de parcourir tous vos problèmes par compte. Il permet également certaines fonctionnalités de filtrage sur les problèmes.

Si vous ne fournissez aucune donnée de filtrage, vous obtiendrez les données du problème pour les dernières 24 heures.

Demande

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

Résultats

{
  "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"
                ]
              },

Notez que le nombre maximal de problèmes pouvant être renvoyés via la pagination est défini par la valeur NRQL LIMIT MAX et qu'un filtrage sera nécessaire si cette limite est dépassée.

Demande initiale

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

Premiers résultats

{
  "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"
          }
        }
      }
    }
  },

Ensuite, dans votre demande suivante, indiquez la valeur du curseur de la réponse précédente nextCursor , jusqu'à ce que nextCursor soit vide.

La demande suivante devrait être la suivante :

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

Filtrez les problèmes par GUID d'entité, types d'entité, priorité des problèmes ou états des problèmes ou toute combinaison de ces attributs.

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

Ici, entityGuides et entityTypes sont les attributs d'entité définis dans la page En savoir plus sur l'entité New Relic .

La priorité du problème peut être l'une des suivantes : LOW, MEDIUM, HIGH, CRITICAL
Les états des problèmes peuvent être l'un des suivants : CREATED, ACTIVATED, DEACTIVATED, CLOSED
timeWindow avec les heures de début et de fin au format EpochMilliseconds. Si elle n'est pas fournie, la valeur par défaut est les dernières 24 heures
Et cursor comme nous l'avons déjà vu

Trouvons les problèmes avec la priorité CRITICAL et l'état CLOSED:

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

Résultats

{
  "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)'"
                ]
              },

Les résultats peuvent être filtrés davantage par entityGuid.

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

Résultats

{
  "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
          }

NerdGraph vous permet également d'effectuer une requête par ID de problème.

Demande

{
  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
        }
      }
    }
  }
}

Résultats

{
  "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
          }
        }

Lister et filtrer les événements problématiques

La requête issuesEvents vous permet de paginer tous vos événements par compte. Il permet également certaines fonctionnalités de filtrage sur les événements problématiques.

Si vous ne fournissez aucune donnée de filtrage, vous obtiendrez les données des événements problématiques des dernières 24 heures.

Demande

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

Résultats

{
  "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'"
                ]
              },

Filtrez les événements de problème par entityGuids, entityTypes, priorité des problèmes ou états des problèmes ou toute combinaison de ces attributs.

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

timeWindow avec les heures de début et de fin au format EpochMilliseconds . Si elle n'est pas fournie, la valeur par défaut correspond aux dernières 24 heures
Et cursor comme nous l'avons déjà vu

Trouvons issuesEvents pour un issueId spécifique.

{
  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'"
                ]
              },
...

Lister et filtrer les incidents

La requête incidents vous permet de parcourir tous vos incidents par compte. Il permet également certaines fonctionnalités de filtrage sur chaque incident.

Les types d’incidents suivants sont pris en charge :

Incident de NewRelic
AnomalieIncident
Incident de repos

Si vous ne fournissez aucune donnée de filtrage, vous obtiendrez les données d'incident des dernières 24 heures.

L'exemple ci-dessous récupère l'incident NewRelicIncident :

Demandes

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

Résultats

{
  "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
              },

Pagination du curseur

Notez que le nombre maximal d'incidents pouvant être renvoyés via la pagination est défini par la NRQL LIMIT MAX et qu'un filtrage sera nécessaire si cette limite est dépassée.

Incident de filtre

Filtrez les incidents par GUID d'entité, types d'entité, priorité des problèmes, états des problèmes ou toute combinaison de ceux-ci.

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

timeWindow avec les heures de début et de fin au format EpochMilliseconds . Si elle n'est pas fournie, la valeur par défaut est les dernières 24 heures.
Et cursor comme nous l’avons déjà vu.
Trouvons un incident avec la priorité CRITICAL et l’état 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
            }
          }
        }
      }
    }
  }
}

Résultats

{
  "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
              },

L'API vous permet d'effectuer une requête par identifiant d'incident :

Demande

{
  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
            }
          }
        }
      }
    }
  }
}

Résultat

{
  "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
              }
            ]
          }
        }
      }
    }
  },

Lister et filtrer les événements incident

La requête incidentsEvents vous permet de paginer tous vos événements incidents par compte. Il permet également certaines fonctionnalités de filtrage sur l'événement incident.

Si vous ne fournissez aucune donnée de filtrage, vous obtiendrez les données d'événement d'incident pour les dernières 24 heures.

Demande

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

Résultats

{
  "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
              },

Pagination du curseur

Afin de paginer vos données, vous devez inclure le champ nextCursor dans votre requête initiale.

Filtrer l'événement incident

Filtrez les événements incident par guides d'entité, types d'entité, priorité incident ou états incident ou toute combinaison de ceux-ci.

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

timeWindow avec les heures de début et de fin au format EpochMilliseconds . Si elle n'est pas fournie, la valeur par défaut est les dernières 24 heures.
Et cursor comme nous l’avons déjà vu.

Interrogeons incident événement, afin d'obtenir leurs « incidentId » :

{
  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
            }
          }
        }
      }
    }
  }
}

Résultats

{
  "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'"
                ],

Configurer la fonctionnalité des problèmes

Le service de problèmes a certains paramètres configuration .

Pour obtenir le paramètre configuration actuel de votre environnement, vous pouvez exécuter la requête configByEnvironment.

Demande

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

Résultats

{
  "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
            }
          }
        }
      }
    }
  }

Ici, chaque configuration d'environnement a le paramètre suivant :

"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
}

En utilisant le mutations correspondant, vous pouvez également modifier les paramètres configuration de l'environnement issueTtl et gracePeriod.

aiIssuesUpdateIssueTtl
aiIssuesUpdateGracePeriod

Demande

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

Résultats

{
  "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
    }
  },

Reconnaître ou non les problèmes

En utilisant mutations vous pouvez reconnaître ou non et résoudre le problème donné par son issueId.

aiIssuesAckIssue
aiIssuesResolveIssue
aiIssuesUnackIssue

Demande

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

Résultats

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

Exécution à partir de la ligne de commande

Pour exécuter une requête depuis la ligne de commande :

1 Obtenez votre clé API, récupérez-en une ou créez-en une dans l'clé API UI.

2 Exportez-le vers votre shell avec export API_KEY=my_api_key

3 Exécutez ces exemples :

Important

Vous devez inclure un en-tête d'inscription expérimental dans vos requests. Sinon, vous obtenez des erreurs d’accès comme celle-ci :

{"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"]}]}%

Listez tous les problèmes des dernières 24 heures

À quoi requests ressemblent dans GraphQL UI

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

Depuis la ligne de commande la même requête

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

Résultats

{
  "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"
                ]
              },
              ...

Cette traduction automatique est fournie pour votre commodité.

Tutoriel NerdGraph : de incident requêtes sur les problèmes et API

Type de problème .css-21sua1{background:none;border:none;width:0;padding:0;}

Cycle de vie et état du problème

Type d'incident

Lister et filtrer les problèmes

Pagination du curseur

Problèmes de filtre

Rechercher des problèmes par ID

Lister et filtrer les événements problématiques

Liste des problèmes événement

Problème de filtre événement

Lister et filtrer les incidents

Liste des incidents

Incident de filtre

Rechercher un incident par ID incident

Lister et filtrer les événements incident

Liste des événements incident

Filtrer l'événement incident

Configurer la fonctionnalité des problèmes

Requête ConfigByEnvironment

Reconnaître ou non les problèmes

Reconnaître ou non les problèmes

Exécution à partir de la ligne de commande

Important

Exemple : lister tous les problèmes

Type de problème