Lorsque des utilisateurs adressent des requêtes à votre API, Extensible Service Proxy (ESP) utilise Cloud Logging pour enregistrer des informations sur ces requêtes et sur les réponses renvoyées. Cette page décrit les informations ainsi consignées.
Pour localiser les journaux Cloud Endpoints sur la page de l'explorateur de journaux:
Dans la console Google Cloud , accédez à la page Operations > Logging (Opérations > Journaux) :
L'objet jsonPayload contient toutes les informations transmises par ESP. Le tableau suivant décrit les champs de cet objet :
Champ
Description
url
Chemin de l'URL de la requête.
producer_project_id
ID du projetGoogle Cloud propriétaire de l'API.
api_name
Nom de l'API appelée.
api_version
Version de l'API appelée.
api_method
Méthode de l'API appelée.
api_key
Clé API utilisée par le client appelant, le cas échéant.
http_method
Méthode HTTP de la requête, telle que GET et POST.
request_size_in_bytes
Taille du corps de la requête en octets.
http_response_code
Code d'état HTTP de la réponse, tel que 200, 404 et 500.
response_size_in_bytes
Taille du corps de la réponse en octets.
request_latency_in_ms
Délai de réponse à la requête en millisecondes, y compris le temps pris par ESP et son backend. Champ non fourni pour les méthodes de traitement par flux.
timestamp
Horodatage de l'arrivée de la requête.
location
ZoneGoogle Cloud ayant traité la requête.
log_message
Message court sur la méthode appelée et sur son état en cas de rejet. Aucun des champs d'information relatifs à l'API n'est enregistré pour les appels rejetés.
error_cause
Message d'erreur si la réponse était une erreur.
labels
La section labels contient des informations qui identifient cette source du journal, telles que l' Google Cloud ID de projet, le nom du service Endpoints, le numéro de version de l'API et le nom de la méthode.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eExtensible Service Proxy (ESP) logs request and response information to Cloud Logging when users make requests to your API.\u003c/p\u003e\n"],["\u003cp\u003eYou can find Cloud Endpoints logs in the Logs Explorer page by selecting "Produced API, SERVICE_NAME," where SERVICE_NAME is the name of your Endpoints service.\u003c/p\u003e\n"],["\u003cp\u003eEach log contains a structured JSON message that includes details such as \u003ccode\u003eurl\u003c/code\u003e, \u003ccode\u003eapi_name\u003c/code\u003e, \u003ccode\u003ehttp_method\u003c/code\u003e, \u003ccode\u003ehttp_response_code\u003c/code\u003e, and \u003ccode\u003erequest_latency_in_ms\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003elabels\u003c/code\u003e section in the log provides identifying information about the log's source, including the Google Cloud project ID, Endpoints service name, API version number, and method name.\u003c/p\u003e\n"]]],[],null,["# Endpoints logs\n\n[OpenAPI](/endpoints/docs/openapi/ref-endpoints-logs \"View this page for the Cloud Endpoints OpenAPI docs\") \\| gRPC\n\n\u003cbr /\u003e\n\nWhen users make requests to your API,\n[Extensible Service Proxy (ESP)](/endpoints/docs/grpc/glossary#extensible_service_proxy)\nuses Cloud Logging to log information\nabout the requests and responses. This page describes the information logged.\n\nTo locate Cloud Endpoints logs on the **Logs Explorer** page:\n\n1. In the Google Cloud console, go to the **Operations** \\\u003e **Logging**\n page:\n\n\n [Go to the Logs Explorer page](https://console.cloud.google.com/logs/query)\n\n \u003cbr /\u003e\n\n2. Select **Produced API, \u003cvar translate=\"no\"\u003eSERVICE_NAME\u003c/var\u003e** , where\n \u003cvar translate=\"no\"\u003eSERVICE_NAME\u003c/var\u003e is the name of the\n Endpoints service.\n\n | **Note:** You can select **Produced API** from the resource menu only if a recent log message contains the **API** resource type.\n\n \u003cbr /\u003e\n\n3. Click the log you want to investigate. The log contains a structured JSON\n message such as the following:\n\n {\n insertId: \"...\"\n jsonPayload: {...}\n resource: {\n type: \"api\"\n labels: {...}\n }\n timestamp: \"2017-05-08T15:00:02.804424422Z\"\n severity: \"INFO\"\n logName: \"...\"\n }\n\nThe `jsonPayload` object contains all the information reported by\nESP. The following table describes its fields:\n\nWhat's next\n-----------\n\n- [Monitoring your API](/endpoints/docs/grpc/monitoring-your-api)\n\n\u003c!-- --\u003e\n\n- [Tracing your API](/endpoints/docs/grpc/tracing)"]]