Exemples d'API pour les rapports SLA

New Relic stocke les données SLA pour toujours pour les comptes éligibles, vous pouvez donc utiliser l'UIAPI REST New Relic pour générer des rapports d'accord de niveau de service sur n'importe quelle période. Par exemple, vous pouvez créer des rapports SLA remontant à plus de 12 jours, semaines ou mois.

Conseil

L'accès à cette fonctionnalité dépend de votre niveau d'abonnement.

navigateur métriques pour SLA

les métriques du navigateur pour le niveau End user ne sont disponibles que si vous avez installé l'agent .

Browser (End user tier)	SLA metric name:value (and formula)
Pages vues en milliers	Utilisateur final : nombre_d'appels
Temps de chargement en secondes	EndUser : average_response_time
Apdex	Utilisateur final/Apdex : score
% Satisfait	EndUser/Apdex : s divisé par EndUser : call_count
% Tolérant	EndUser/Apdex : t divisé par Enduser : call_count
% Frustré	EndUser/Apdex : f divisé par Enduser : call_count

Métriques du serveur d'applications pour SLA

Voici les métriques SLA pour les serveurs d’applications.

App server	SLA metric name:value (and formula)
Des millions de demandes	HttpDispatcher : call_count (mis à l'échelle de manière appropriée)
Temps de réponse ms	HttpDispatcher : average_response_time (multiplié par 1000)
Apdex	Apdex : score
% Satisfait	Apdex : s divisé par Apdex : nombre
% Tolérant	Apdex : t divisé par Apdex : nombre
% Frustré	Apdex : f divisé par Apdex : nombre

Conseils pour collecter des métriques

Voici quelques conseils pour planifier les métriques à collecter.

SLA tips	Comments
Exigences	Lorsque vous utilisez les exemples de commande cURL, assurez-vous de remplacer le texte espace réservé par votre ID de compte, une clé API et l'UIidentifiant d'application.
Plages horaires	Vous n'êtes pas limité aux plages horaires standard de jour, de semaine ou de mois. Par exemple, vous pouvez extraire des données métriques pour un « week-end férié » du 23/12 au 26/12 ou « les 20 minutes après que notre site ait eu des problèmes » ou toute autre période qui vous intéresse.
Format de l'heure XML UTC	Vous devez spécifier l'heure au format XML UTC, assurez-vous donc de l'ajuster à votre fuseau horaire par rapport à UTC. Par exemple, New Relic démarre à 16h00 la veille des données sélectionnées, puisque le siège social de New Relic se trouve en UTC-8.
Rapports de synthèse	Lorsque vous demandez des métriques à utiliser avec des rapports récapitulatifs, incluez le paramètre de chaîne de requête `summarize=true` (v2) ou `summary=1` (v1) comme indiqué dans les exemples.
Statistiques à l'échelle	Votre rapport contient certaines statistiques qui sont mises à l'échelle dans les rapports SLA de l'interface utilisateur de New Relic. New Relic modifie l'échelle des pages vues dans votre rapport pour afficher de petits nombres. En fonction de votre trafic, il peut généralement être affiché en milliers, en millions ou en milliards. Recommandation : pour éviter une chaîne de zéros, divisez ce nombre de manière appropriée à vos propres besoins.
Statistiques de l'utilisateur final	Les statistiques de l’utilisateur final refléteront uniquement les appels dans lesquels l’agent a collecté des données de navigateur. Par exemple, les statistiques de l'utilisateur final peuvent ne pas apparaître dans des situations telles que : types de navigateurs Les clients (ils ont peut-être désactivé l'agent JavaScript ou bloqué le trafic vers les sites New Relic pour l'emplacement du code JavaScript) Transactions n'appartenant pas à l'une de ces catégories, au cas où le chargement de la page ne se serait pas terminé pour une raison quelconque C'est pourquoi il y a moins (parfois beaucoup moins) de pages vues dans la section End User (données de navigateur) que dans la section App server (données).

Exemples

Les sections suivantes contiennent des exemples de code permettant d'acquérir les données pour les valeurs décrites ci-dessus pour les statistiques SLA quotidiennes (24 heures) dans le fuseau horaire GMT/UTC par défaut. Ajustez les from= et to= pour votre plage horaire comme vous le souhaitez.

Important

Although the examples include both New Relic's REST API v2 and NerdGraph, we recommend using NerdGraph for querying New Relic data, retrieving account information, and configuring features. To explore its capabilities, check the NerdGraph tutorials.

Commandes de l'API REST v2

Pour obtenir le temps de chargement du navigateur (EndUser/RUM) et le nombre de pages vues pour la v2, à partir de la ligne de commande, saisissez :

bash

$curl -X GET "https://api.newrelic.com/v2/applications/$APP_ID/metrics/data.xml"\
>    -H "Api-Key:$API_KEY" -i  \
>    -d "names[]=EndUser&values[]=call_count&values[]=average_response_time&from=2014-06-09T00:00:00+00:00&to=2014-06-09T23:00:00+00:00&summarize=true"

En Ruby :

require 'rubygems'
require 'curb'

response = Curl::Easy.http_get("https://api.newrelic.com/v2/applications/$APP_ID/metrics/data.xml?names[]=EndUser&values[]=call_count&values[]=average_response_time&from=2012-01-01T00:00:00+00:00&to=2012-01-08T00:00:00+00:00&summarize=true") do |curl|
  curl.headers["api-key"] = "$API_KEY"
  curl.header_in_body=true
end
puts response.body_str

Pour obtenir le temps de réponse de l'application et le nombre de requêtes pour la version 2, à partir de la ligne de commande, saisissez :

bash

$curl -X GET "https://api.newrelic.com/v2/applications/$APP_ID/metrics/data.xml" \
>     -H "Api-Key:$API_KEY" -i \
>     -d "names[]=HttpDispatcher&values[]=average_response_time&values[]=call_count&from=2014-06-09T00:00:00+00:00&to=2014-06-09T23:00:00+00:00&summarize=true"

En Ruby :

require 'rubygems'
require 'curb'

response = Curl::Easy.http_get("https://api.newrelic.com/v2/applications/$APP_ID/metrics/data.xml?names[]=HttpDispatcher&values[]=average_response_time&values[]=call_count&from=2012-01-01T00:00:00+00:00&to=2012-01-08T00:00:00+00:00&summarize=true") do |curl|
  curl.headers["api-key"] = "$API_KEY"
  curl.header_in_body=true
end
puts response.body_str

Pour obtenir les données relatives à Apdex pour la version 2, à partir de la ligne de commande, tapez :

bash

$curl -X GET "https://api.newrelic.com/v2/applications/$APP_ID/metrics/data.xml" \
>     -H "Api-Key:$API_KEY" -i \
>     -d 'names[]=Apdex&names[]=EndUser/Apdex&from=2014-06-09T00:00:00+00:00&to=2014-06-09T23:00:00+00:00&summarize=true'

En Ruby :

require 'rubygems'
require 'curb'

response = Curl::Easy.http_get("https://api.newrelic.com/v2/applications/$APP_ID/metrics/data.xml?names[]=EndUser/Apdex&from=2012-01-01T00:00:00+00:00&to=2012-01-08T00:00:00+00:00&summarize=true") do |curl|
  curl.headers["api-key"] = "$API_KEY"
  curl.header_in_body=true
end
puts response.body_str

NerdGraph API commands

To obtain the Application average response time, execute the following query in the NerdGraph API Explorer:

SELECT average(apm.service.transaction.duration) as duration 
FROM WHERE (entity.guid = 'Nzc5ODIwfEFQTXxBUFBMSUNBVElPTnwzMjMzNDE2') 
FACET weekOf(timestamp) 
LIMIT MAX 
SINCE '2025-02-03' 
TIMESERIES

To obtain the Application request count, execute the following query in the NerdGraph API Explorer:

SELECT ((count(apm.service.transaction.duration))/1000) 
FROM WHERE (entity.guid = 'Nzc5ODIwfEFQTXxBUFBMSUNBVElPTnwzMjMzNDE2') 
FACET weekOf(timestamp) 
LIMIT MAX 
SINCE '2025-02-03' 
TIMESERIES

To obtain the Apdex related data, execute the following query in the NerdGraph API Explorer:

SELECT apdex(apm.service.apdex) 
FROM Metric 
WHERE (entity.guid = 'Nzc5ODIwfEFQTXxBUFBMSUNBVElPTnwzMjMzNDE2') 
FACET weekOf(timestamp) 
LIMIT MAX 
SINCE '2025-02-03' 
TIMESERIES

Commandes API REST v1 (obsolètes)

L'API REST v1 est obsolète.

Pour obtenir le temps de chargement du navigateur (EndUser/RUM) et le nombre de pages vues pour la v1, à partir de la ligne de commande, saisissez :

bash

$curl -gH "api-key:$API_KEY" "https://api.newrelic.com/api/v1/accounts/$ACCOUNT_ID/applications/$APP_ID/data.xml?metrics[]=EndUser&field=call_count&field=average_response_time&summary=1&begin=2012-01-01T00:00:00Z&end=2012-01-08T00:00:00Z"

En Ruby :

require 'rubygems'
require 'curb'

response = Curl::Easy.perform("https://api.newrelic.com/api/v1/accounts/$ACCOUNT_ID/applications/$APP_ID/data.xml?metrics[]=EndUser&field=call_count&field=average_response_time&summary=1&begin=2012-01-01T00:00:00Z&end=2012-01-08T00:00:00Z") do |curl|
  curl.headers["api-key"] = "$API_KEY"
end
puts response.body_str

Pour obtenir le temps de réponse de l'application et le nombre de requêtes pour v1, à partir de la ligne de commande, saisissez :

bash

$curl -gH "api-key:$API_KEY" "https://api.newrelic.com/api/v1/accounts/$ACCOUNT_ID/applications/$APP_ID/data.xml?metrics[]=HttpDispatcher&field=average_response_time&field=call_count&summary=1&begin=2012-01-01T00:00:00Z&end=2012-01-08T00:00:00Z"

En Ruby :

require 'rubygems'
require 'curb'

response = Curl::Easy.perform("https://api.newrelic.com/api/v1/accounts/$ACCOUNT_ID/applications/$APP_ID/data.xml?metrics[]=HttpDispatcher&field=average_response_time&field=call_count&summary=1&begin=2012-01-01T00:00:00Z&end=2012-01-08T00:00:00Z") do |curl|
  curl.headers["api-key"] = "$API_KEY"
end
puts response.body_str

Pour obtenir les données relatives à Apdex pour la version 1, à partir de la ligne de commande, tapez :

bash

$curl -gH "api-key:$API_KEY" "https://api.newrelic.com/api/v1/accounts/$ACCOUNT_ID/applications/$APP_ID/data.xml?metrics[]=Apdex&metrics[]=EndUser/Apdex&summary=1&begin=2012-01-01T00:00:00Z&end=2012-01-08T00:00:00Z"

En Ruby :

require 'rubygems'
require 'curb'

response = Curl::Easy.perform("https://api.newrelic.com/api/v1/accounts/$ACCOUNT_ID/applications/$APP_ID/data.xml?metrics[]=Apdex&metrics[]=EndUser/Apdex&summary=1&begin=2012-01-01T00:00:00Z&end=2012-01-08T00:00:00Z") do |curl|
  curl.headers["api-key"] = "$API_KEY"
end
puts response.body_str

Analysez vos données

APM inclut plusieurs rapports dans l'interface utilisateur. Pour collecter, analyser et visualiser des données sur votre logiciel dans d'autres formats, utilisez le dashboard.

Cette traduction automatique est fournie pour votre commodité.

Conseil

navigateur métriques pour SLA

Métriques du serveur d'applications pour SLA

Conseils pour collecter des métriques

Exemples

Important

Commandes de l'API REST v2

Temps de chargement du navigateur et nombre de pages vues (v2)

App temps de réponse et nombre de requêtes (v2)

Données SLA Apdex (v2)

NerdGraph API commands

App average response time (NerdGraph)

App request count (NerdGraph)

Apdex SLA data (NerdGraph)

Commandes API REST v1 (obsolètes)

Temps de chargement du navigateur et nombre de pages vues (v1)

App temps de réponse et nombre de requêtes (v1)

Données SLA Apdex (v1)

Analysez vos données

Cette traduction automatique est fournie pour votre commodité.

Exemples d'API pour les rapports SLA

Conseil

navigateur métriques pour SLA .css-21sua1{background:none;border:none;width:0;padding:0;}

Métriques du serveur d'applications pour SLA

Conseils pour collecter des métriques

Exemples

Important

Commandes de l'API REST v2

App temps de réponse et nombre de requêtes (v2)

Données SLA Apdex (v2)

NerdGraph API commands

App average response time (NerdGraph)

App request count (NerdGraph)

Apdex SLA data (NerdGraph)

Commandes API REST v1 (obsolètes)

Temps de chargement du navigateur et nombre de pages vues (v1)

App temps de réponse et nombre de requêtes (v1)

Données SLA Apdex (v1)

Analysez vos données

navigateur métriques pour SLA