O APM da New Relic atribui IDs à entidade relacionada a uma aplicação. Eles são usados para coletar informações sobre a operação e o desempenho de diferentes pontos de vista. Esses IDs podem ser retornados por meio da API REST da New Relic.
Os IDs podem incluir:
- ID do aplicativo
$APP_ID
para cada aplicativo de instrumento - ID do host
$HOST_ID
para cada host - ID da instância
$INSTANCE_ID
se houver várias instâncias do aplicativo
Para listar qualquer um desses IDs no New Relic API Explorer, você precisa de uma chave de API.
Use o API Explorer
- Vá para o API Explorer.
- No dropdown Servers, escolha uma URL API baseada nos EUA ou na UE.
- Clique em Authorize, insira sua chave de API de usuário e clique em Authorize novamente.
- Expanda uma das funções de API disponíveis: GET, PUT, DELETE.
- (Opcional) Adicione valores Parameters para sua chamada de API para filtrar a resposta (consulte a interface para obter descrições e requisitos para a v2.)
- No dropdown Media type, escolha um formato para sua solicitação: JSON ou XML.
- Clique em Try it out e depois em Execute.
Listar IDs de produtos
Para retornar uma lista de todos os IDs de produtos para um produto específico:
- Clique no dropdown
GET /applications.json
. - Clique em Try it out e depois em Execute.
- Navegue pela resposta para visualizar todos os IDs de produtos.
Depois de localizar um ID de produto específico, copie-o para mais tarde em sua outra chamada de API REST.
ID da lista do aplicativo
Cada aplicativo monitorado por um agente recebe um nome. Um $APP_ID
exclusivo também está associado a esse nome. O $APP_ID
é fundamental para recuperar informações sobre seus aplicativos. Para obter mais informações sobre como listar e usar o $APP_ID
e como obter os dados resumidos, consulte Listando o ID do seu aplicativo.
ID da lista do host
O $HOST_ID
é usado para obter dados de APM para um host específico que executa um aplicativo. Um servidor físico pode ter mais de um host. Por exemplo, um programa de servidor web executado em um servidor físico pode ser configurado para ter mais de um host virtual.
Os IDs do host e do servidor físico não são iguais. Cada ID do host é único e representa itens diferentes.
Use $HOST_ID
para recuperar métricas resumidas do host, bem como valores específicos de métrica de fração de tempo. Para mais informações sobre métricas disponíveis:
- Vá para rpm.newrelic.com.
- Acesse o API Explorer e selecione o nome da sua conta no dropdown Select an account .
- Acesse a página Application host do API Explorer em rpm.newrelic.com/api/explore/application_hosts/names.
ID da lista da instância
O significado do ID da instância depende do agente de idiomas da New Relic que está sendo usado. Você pode listar esse ID na API REST. Para Java, você também pode visualizar o ID da instância (JVM) na página Overview do APM.
Agente | ID da instância representa |
---|---|
Go | O programa Go no host reportando ao nome do aplicativo |
Java | Uma máquina virtual Java (JVM) |
.NET | Para o agente para .NET framework, este é o |
Node.js | Um processo de trabalho |
PHP | O agente daemon |
Ruby | Um processo de trabalho Ruby individual |
Python | Os processos mestre e de trabalho |
Você pode recuperar métricas de resumo para a instância, bem como valores específicos de métrica de fração de tempo usando o {INSTANCE_ID}
. Para obter detalhes sobre as métricas disponíveis, use a página de instância do aplicativo REST API Explorer .
Exemplo de lista de aplicativos da API REST
O exemplo a seguir mostra como localizar todas as informações de ID de um aplicativo usando APP_ID
. Se você tiver uma conta da UE, o endpoint começa com https://api.eu.newrelic.com
.
curl -X GET 'https://api.newrelic.com/v2/applications.json' \
-H "Api-Key:$API_KEY" -i \
-d 'filter[ids]=1441' <----<<<< {APP_ID}
A saída de exemplo resultante está em execução em cinco servidores. Um servidor hospeda dois hosts virtuais, totalizando seis hosts. A saída inclui uma seção links
listando application_instances
e application_hosts
para o aplicativo.
{ "applications": [ { "id": 1441, <----<<<< {APP_ID} "name": "RPM Combined Production", "language": "ruby", "health_status": "green", "reporting": true, "last_reported_at": "2015-11-10T23:19:47+00:00", "application_summary": { . . . }, "end_user_summary": { . . . }, "settings": { . . . }, "links": { "application_instances": [ <---<<<< {INSTANCE_ID} list 21790, 24810, 27948, 35120, 35121, 35122, 186288, 247253, 247254, 247255, 247256 ], "application_hosts": [ <---<<<< {HOST_ID} list 21788, 24808, 34966, 186283, 247245, 286551 ] } } ],. . .