Afficher les journaux à l'aide de l'API

Vous consultez la documentation d'Apigee Edge.
Accédez à la documentation sur Apigee X. info

Téléchargez les journaux de surveillance de l'API pour afficher les données brutes utilisées pour calculer les métriques affichées dans les tableaux de bord de surveillance de l'API. Vous pouvez télécharger des journaux pour des plages de temps personnalisées, des mandataires spécifiques, des codes d'état spécifiques et pour de nombreuses autres variables.

Remarque:Par défaut, les appels à l'API Logs ne renvoient que des résultats avec les codes d'état 4xx et 5xx, mais pas avec le code 2xx. Cela permet de limiter le nombre de résultats, car la plupart d'entre eux ont un code d'état 2xx. Pour obtenir des résultats avec le code d'état 2xx, ajoutez status=2xx à la requête. Exemple : https://apimonitoring.enterprise.apigee.com/logs?status=2xx.

Les sections suivantes décrivent comment gérer les journaux à l'aide de l'API:

Pour en savoir plus sur l'API Logs, consultez la section API Logs.

Pour en savoir plus sur les options cURL utilisées dans ces exemples, consultez la section Utiliser cURL.

Télécharger les journaux pour une organisation et un environnement

Téléchargez les journaux d'une organisation et d'un environnement spécifiques à l'aide de l'API Logs:

https://apimonitoring.enterprise.apigee.com/logs

Vous devez transmettre le nom de l'organisation et de l'environnement à l'aide des paramètres de requête org et env.

Par défaut, l'API renvoie les 10 dernières entrées de journal de l'heure précédente. Exemple :

curl -X GET \
"https://apimonitoring.enterprise.apigee.com/logs?org=myorg&env=prod" \
-H "accept: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN"

Définissez $ACCESS_TOKEN sur votre jeton d'accès OAuth 2.0, comme décrit dans la section Obtenir un jeton d'accès OAuth 2.0.

La réponse est un tableau d'entrées de journal sous la forme:

[   
  {
"request":"GET /v1/o/myorg/z HTTP/1.1",
    "request_length":1349,
    "request_message_id":"rrt-0623eb157b650315c-c-ne-7785-16029140-1",
    "virtual_host":"api.enterprise.apigee.com",
    "response_size":144,
    "response_time":0.551,
    "response_status":"404",
    "timestamp":"2018-08-14T17:31:07Z",
    "fault_code":"messaging.adaptors.http.flow.ErrorResponseCode",
    "fault_flow":"-",
    "fault_policy":"null/null",
    "fault_proxy":
        "/organizations/myorg/environments/prod/apiproxies/myAPI/revisions/50",
    "fault_source":"target"
  },
  …
]

Utilisez les paramètres de requête from et to pour spécifier une plage de temps au format ISO. Le format de la date peut être soit:

  • yyyy-mm-ddThh:mm:ssZ
  • yyyy-mm-ddThh:mm:ss+00:00

Exemple :

curl -X GET \
"https://apimonitoring.enterprise.apigee.com/logs?org=myorg&env=prod&from=2018-08-13T14%3A04%3A00Z&to=2018-08-13T14%3A10%3A00Z" \
-H "accept: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN"

L'API a de nombreux paramètres de requête facultatifs. Par exemple, pour voir les journaux d'un proxy nommé myAPI générant des réponses HTTP 404:

curl -X GET \
"https://apimonitoring.enterprise.apigee.com/logs?org=myorg&env=prod&proxy=myAPI&status=404" \
-H "accept: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN"

Pour renvoyer plus de 10 entrées de journal, définissez le paramètre de requête limit. Vous pouvez définir une valeur maximale de 1 000:

curl -X GET \
"https://apimonitoring.enterprise.apigee.com/logs?org=myorg&env=prod&proxy=myAPI&status=404&limit=200" \
-H "accept: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN"

Pour des options supplémentaires, consultez l'API Logs.

Répertorie les mandataires associés à un hôte virtuel et à un chemin de base

Un hôte virtuel sur un routeur Edge vous permet de spécifier un nom de domaine, un protocole tel que HTTP/HTTPS et un numéro de port. Par exemple, vous définissez un hôte virtuel sur un routeur Edge avec les paramètres suivants:

  • alias hôte = apis.acme.com
  • port = 443
  • TLS activé

Sur la base de ces paramètres, une requête adressée à un proxy d'API associé à cet hôte virtuel utilise le formulaire suivant:

https://apis.acme.com/proxy-base-path/resource-path

Où :

  • proxy-base-path est défini lorsque vous créez un proxy API et est unique pour chaque proxy API.
  • chemin-ressource est le chemin d'accès à une ressource accessible via le proxy API.

Pour plus d'informations sur les hôtes virtuels, voir À propos des hôtes virtuels.

Téléchargez la liste des serveurs proxy d'API associés à un hôte virtuel et à un chemin de base spécifiques en envoyant une demande GET à la ressource suivante de l'API Logs:

https://apimonitoring.enterprise.apigee.com/logs/apiproxies

Vous devez transmettre le nom de l'organisation et de l'environnement à l'aide des paramètres de requête org et env, ainsi que l'URI associé à l'hôte virtuel et au chemin de base.

Par exemple, l'appel d'API suivant renvoie les mandataires associés à l'hôte virtuel http://apis.acme.com et au chemin de base de /v1/perf:

curl -X GET \
"https://apimonitoring.enterprise.apigee.com/logs/apiproxies?org=myorg&env=prod&select=http://apis.acme.com/v1/perf" \
-H "accept: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN"

Définissez $ACCESS_TOKEN sur votre jeton d'accès OAuth 2.0, comme décrit dans la section Obtenir un jeton d'accès OAuth 2.0.

Pour des options supplémentaires, consultez l'API Logs.