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 |
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: |
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: |
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: |
estado | Estado do Incidente. | Estado do incidente. Pode ser um dos seguintes: |
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.
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.
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
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.
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
.
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
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"]}]}%