O REST API Explorer também inclui o formato de solicitação curl, parâmetro disponível, possíveis códigos de status de resposta e estrutura de resposta JSON para cada chamada de API disponível. Você também pode criar condição do alerta na interface.
Antes de usar a API REST
Antes de usar a API REST para gerenciar dados de alertas, leia a introdução à API de .
Para alertas de infraestrutura, consulte [API REST para monitoramento de alertas de infraestrutura](/docs/infrastructure/new-relic-infrastructure/infrastructure-alert-conditions/
Dados e funções disponíveis via REST API
REST API functions
Comments
Ver dados da conta
Em geral, qualquer função pode usar uma chave ou de API REST com GET > List funções para view alertar dados. O proprietário e os administradores da conta podem usar sua chave de API.
A saída da lista será paginada. As funções disponíveis incluem:
Você pode ter uma função de Proprietário ou Administrador em sua conta and uma chave de usuárioor ter uma função personalizada que concede permissões para gerenciar alertas and uma chave de usuário para usar qualquer função de manutenção, incluindo POST > Create, PUT > Add, PUT > Update e DELETE.
Condições excluídas da API REST
Esses tipos de condições não possuem endpoint disponível na API:
APM: transação da web percentil, condições de segmentação de rótulos e anomalia
NRQL: anomalia
Política de alertas
Essas funções de API incluem links para o API Explorer, onde você pode criar, excluir ou listar políticas.
Para excluir uma política existente, use sua chave de usuário e inclua policy_id (disponível em API Explorer > Alerts Policies > GET > List) na chamada de API:
API Explorer > Alerts Policies > DELETE > Delete
API Explorer > Alerts Policies > GET > List
curl -X GET 'https://api.newrelic.com/v2/alerts_policies.json' \
-H "X-Api-Key:$API_KEY" -i
Condições para APM, browser, mobile
Essas funções de API incluem links para o API Explorer, onde você pode criar, atualizar, excluir ou listar condições de política. Estas chamadas são para condições com estes tipos de entidade:
APM: Apps e transação principal
Browser: Apps e transação principal
mobile: aplicativos móveis
Exception: As seguintes condições de APM são not available destes endpoints da API:
Rótulos de segmentação por condições (segmentação dinâmica)
Condições de porcentagem de transação da web
Condições de anomalia
Importante
O API Explorer fornece informações sobre outros tipos de condições usando separate endpoints, incluindo serviços externos (APM e dispositivos móveis) e monitoramento sintético. Considere todos os tipos de condição do alerta ao pesquisar ou atualizar. Se sua conta hospedar dados no data center da UE, certifique-se de usar os endpoints de API adequados para contas da região da UE.
Para adicionar condições às políticas, inclua estes valores na chamada de API:
Seu
O policy_id (disponível em API Explorer > Alerts Policies > GET > List)
A resposta JSON retorna uma condição id, que será necessária para atualizar ou excluir a condição. Você também pode visualizar a condição id de API Explorer > Alerts Conditions > GET > List.
Para atualizar as condições das políticas, inclua estes valores na chamada de API:
Recomendação: Devido à forma como os dados NRQL são transmitidos, defina aggregation_method como EVENT_FLOW e use as configurações padrão de 60 para aggregation_window e 120 para aggregation_delay. EVENT_FLOW funciona na maioria dos casos de uso, mas para uma discussão sobre quais casos de uso funcionam melhor com EVENT_TIMER, consulte Qual método de agregação usar?.
API Explorer > Alerts NRQL Conditions > POST > Create
Para visualizar uma lista de condições existentes para sua política de alertas, use sua chave de usuário ou chave de API REST e o policy_id associado na chamada de API.
API Explorer > Alerts NRQL Conditions > GET > List
Essas funções de API incluem links para o API Explorer, onde você pode criar, atualizar, excluir ou listar condições de política. Estas chamadas são para condições de serviços externos. A chamada de API pode ser usada com e aplicativos de monitoramento de dispositivos móveis.
Para adicionar condições de serviços externos a políticas que possuem aplicativos APM ou monitoramento de Mobile, inclua estes valores na chamada de API:
A resposta JSON retorna uma condição id, que será necessária para atualizar ou excluir a condição. Você também pode visualizar a condição id de API Explorer > Alerts External Service Conditions > GET > List.
Para atualizar condições de serviços externos para políticas que possuem aplicativos APM ou monitoramento de Mobile, inclua estes valores na chamada de API:
Para excluir condições de serviços externos de políticas com APM ou aplicativos de monitoramento de dispositivos móveis, inclua estes valores na chamada de API:
Para visualizar uma lista de condições existentes para políticas com aplicativos de serviços externos (APM ou monitoramento de Mobile), use sua chave de usuário ou chave de API REST e o policy_id associado na chamada de API.
API Explorer > Alerts External Service Conditions > GET > List
Essas funções de API incluem links para o API Explorer, onde você pode criar, atualizar, excluir ou listar condições para sua política de alertas. A chamada de API pode ser utilizada com monitoramento sintético.
Para adicionar condições às políticas para monitoramento sintético, inclua estes valores na chamada de API:
A resposta JSON retorna uma condição id, que será necessária para atualizar ou excluir a condição. Você também pode visualizar a condição id de API Explorer > Alerts Synthetics Conditions > GET > List.
Para atualizar as condições da política para monitoramento sintético, inclua estes valores na chamada de API:
Para visualizar uma lista de condições de política existentes para monitoramento sintético, use sua chave de usuário ou chave de API REST e o policy_id associado na chamada de API.
API Explorer > Alerts Synthetics Conditions > GET > List
Condições de vários locais para monitoramento sintético
Essas funções de API incluem links para o API Explorer, onde você pode criar, atualizar, excluir ou listar condições para sua política de alertas. A chamada de API pode ser usada para condições multilocais com monitoramento sintético. Antes de criar ou atualizar uma condição, leia as regras para condição do alerta em vários locais.
Para adicionar condições às políticas para monitoramento sintético de vários locais, inclua estes valores na chamada de API:
A resposta JSON retorna uma condição id, que será necessária para atualizar ou excluir a condição. Você também pode visualizar a condição id de API Explorer > Alerts Location Failure Conditions > GET > List.
Para atualizar as condições da política para monitoramento sintético de vários locais, inclua estes valores na chamada de API:
Para visualizar uma lista de condições de política existentes para monitoramento sintético de vários locais, use sua chave de usuário ou chave de API REST e o policy_id associado na chamada de API.
API Explorer > Alerts Location Failure Conditions > GET > List
curl -X GET 'https://api.newrelic.com/v2/alerts_location_failure_conditions/policies/$POLICY_ID.json' \
-H "X-Api-Key:$API_KEY" -i
Condições da entidade de alerta
Estas funções da API incluem links para o API Explorer, onde você pode listar, adicionar e remover entidades nas condições da sua política de alertas.
Para visualizar as condições que uma entidade se aplica a uma entidade no APM, browser, mobile ou transação principal, inclua estes valores na chamada da API:
O entity_id Esta é a entidade (destino do alerta) a ser monitorada. É o ID numérico do aplicativo APM, aplicativo de browser, transação principal ou aplicativo mobile.
O condition_id (disponível em API Explorer > Alerts Conditions > GET > List)
O entity_type, que deve ser um dos seguintes:
Aplicativo
Aplicativo de browser
MobileApplication
KeyTransaction
API Explorer > Alerts Entity Conditions > PUT > Add