Aqui estão exemplos de como usar a API REST New Relic (v2) para obter nomes de métricas e valores médios para um ID do aplicativo e chave de API específicos. Os exemplos também mostram diferentes intervalos de tempo.
Ao adquirir dados, os valores retornados podem ser afetados pelo período de tempo especificado e pela forma como os dados são armazenados. Para obter mais informações, consulte Extração de dados de métrica de fração de tempo.
Listar todos os IDs do aplicativo
Você também pode usar o REST API Explorer da New Relic para obter os mesmos dados de métrica de fração de tempo para as informações do seu aplicativo como neste exemplo.
Para visualizar todos os IDs dos seus aplicativos, use o seguinte comando.
$curl -X GET 'https://api.newrelic.com/v2/applications.json' \> -H "Api-Key:$API_KEY" -i
- Substitua
$API_KEY
pela sua chave de API.
A saída será uma matriz de dados onde o elemento é um aplicativo e os dados associados a ele. Por exemplo, aqui estão os dois primeiros elementos para o ID do aplicativo 96785 ("GreatTimes preparação") e 1622 ("GreatTimes Prod"):
{ "applications": [ { "id": 96785, "name": "GreatTimes Staging", "language": "ruby", "health_status": "gray", ... }, { "id": 1622, "name": "GreatTimes Prod", "language": "ruby", "health_status": "green", ... } ]}
Listar o ID do aplicativo por nome
Para visualizar o ID de um aplicativo específico se você souber o nome, substitua o nome por $NAME
e $API_KEY
pela sua chave de API no seguinte comando:
$curl -X GET 'https://api.newrelic.com/v2/applications.json' \> -H "Api-Key:$API_KEY" -i \> -d "filter[name]=$NAME"
A saída será a mesma mostrada no exemplo de lista de todos os IDs de aplicativos , mas apenas para o aplicativo específico.
Diretrizes para listagem de nomes métrica
Listar os nomes de métricas disponíveis para sua aplicação pode ser uma operação muito intensiva e só deve ser usada quando necessário. Listar um grande número de nomes de métricas pode ter um efeito prejudicial na sua capacidade de resposta, bem como em outros usos, e pode levar à invocação de proteção contra sobrecarga.
Siga estas diretrizes para otimizar seu uso:
Listando nomes de métricas | Diretrizes |
---|---|
Nomes métricos | Considere cuidadosamente os nomes das métricas que você precisa. Se você souber alguma parte do nome da métrica, use o filtro |
Cache | Depois de obter os nomes das métricas, considere armazenar esta lista em cache para uso futuro. Na maioria dos casos os nomes das métricas não são voláteis e podem ser reutilizados, economizando tempo de processamento. |
Liste nomes de métricas para seu aplicativo
Para visualizar os nomes de métricas disponíveis para sua aplicação:
$curl -X GET "https://api.newrelic.com/v2/applications/${APP_ID}/metrics.json" \> -H "Api-Key:$API_KEY" -i
- Substitua
$API_KEY
pela sua chave de API.
A saída será semelhante à seguinte. Isto mostra dois dos muitos nomes de métricas disponíveis e seus valores. Essas listas podem ser longas. Por favor, considere as diretrizes para listar seus nomes de métricas.
{ "metrics": [ { "name": "ActiveRecord/Account/create", "values": [ "average_response_time", "calls_per_minute", "call_count", "min_response_time", "max_response_time", "average_exclusive_time", "average_value", "requests_per_minute", "standard_deviation" ] }, ... { "name": "Apdex/members/destroy", "values": [ "s", "t", "f", "count", "score", "value", "threshold", "threshold_min" ] }, ... ]}
Filtre a saída do nome da métrica para retornar uma lista menor, especificando o filtro name=
desta forma:
$curl -X GET "https://api.newrelic.com/v2/applications/${APP_ID}/metrics.json" \> -H "Api-Key:$API_KEY" -i \> -d "name=Controller/welcome/index"
- Substitua
$API_KEY
pela sua chave de API.
Obtenha os valores de dados da métrica de fração de tempo do seu aplicativo
Para visualizar os dados da métrica de fração de tempo para sua aplicação:
$curl -X GET "https://api.newrelic.com/v2/applications/${APP_ID}/metrics/data.json" \> -H "Api-Key:$API_KEY" -i \> -d 'names[]=EndUser&values[]=call_count&values[]=average_response_time&summarize=true'