Questa pagina illustra le tecniche di risoluzione dei problemi quando il proxy di servizio Extensible (ESP) viene dipiegato su una macchina virtuale (VM) Compute Engine.
Visualizzazione dei log nell'istanza VM
Puoi risolvere i problemi esaminando il log di runtime degli endpoint nell'istanza VM.
Per visualizzare il log:
Usa ssh per connetterti alla macchina virtuale:
gcloud config set project YOUR_PROJECT_ID
gcloud compute ssh INSTANCE_NAME
Sostituisci YOUR_PROJECT_ID e
INSTANCE_NAME con il tuo Google Cloud
ID progetto e il nome dell'istanza della macchina virtuale, rispettivamente.
Visualizza il log degli errori nginx:
Se esegui endpoints-runtime su una VM non elaborata:
tail-f/var/log/nginx/error.log
Se esegui endpoints-runtime in Docker:
docker ps
docker logs CONTAINER_NAME
Sostituisci CONTAINER_NAME con il nome del contenitore.
Visualizzazione dello stato dell'ESP
Per visualizzare lo stato dell'ESP:
Usa ssh per connetterti alla tua macchina virtuale:
gcloud config set project YOUR_PROJECT_ID
gcloud compute ssh INSTANCE_NAME
Sostituisci YOUR_PROJECT_ID e
INSTANCE_NAME con il
Google Cloud tuo ID progetto e il nome dell'istanza della macchina virtuale, rispettivamente.
Recupera il nome del contenitore ESP (in genere il nome del contenitore è esp):
docker ps
Ottieni una shell bash nel contenitore:
docker exec -it ESP_CONTAINER_NAME /bin/bash
Sostituisci ESP_CONTAINER_NAME con il nome del
contenitore ESP del passaggio precedente.
Se hai impostato rollout_strategy su managed quando hai avviato ESP e devi trovare l'ID configurazione utilizzato da un'istanza di ESP, l'output del comando curl http://localhost:8090/endpoints_status, verso la fine, è simile al seguente:
Il valore in rolloutId è l'ID configurazione del servizio utilizzato da ESP. Questo ID di configurazione deve corrispondere all'ultima configurazione di cui è stato eseguito il deployment.
Puoi visualizzare la cronologia di implementazione nella pagina Endpoints > Servizi della console Google Cloud e le modifiche apportate alla configurazione del servizio. Consulta
Confronto dei file di configurazione.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-04 UTC."],[[["\u003cp\u003eThis guide provides troubleshooting steps for the Extensible Service Proxy (ESP) when deployed on a Compute Engine virtual machine (VM).\u003c/p\u003e\n"],["\u003cp\u003eYou can view logs by connecting to the VM via \u003ccode\u003essh\u003c/code\u003e and checking the \u003ccode\u003enginx\u003c/code\u003e error log, or using \u003ccode\u003edocker logs\u003c/code\u003e for containerized deployments.\u003c/p\u003e\n"],["\u003cp\u003eThe ESP status can be displayed by accessing the container's bash shell and executing the \u003ccode\u003ecurl http://localhost:8090/endpoints_status\u003c/code\u003e command.\u003c/p\u003e\n"],["\u003cp\u003eThe service configuration ID used by ESP can be found in the output of \u003ccode\u003ecurl http://localhost:8090/endpoints_status\u003c/code\u003e within the \u003ccode\u003erolloutId\u003c/code\u003e value.\u003c/p\u003e\n"]]],[],null,["# Troubleshooting Cloud Endpoints on Compute Engine\n\n[OpenAPI](/endpoints/docs/openapi/troubleshoot-gce-deployment \"View this page for the Cloud Endpoints OpenAPI docs\") \\| gRPC\n\n\u003cbr /\u003e\n\nThis page presents troubleshooting techniques when the\nExtensible Service Proxy (ESP) is deployed on a Compute Engine virtual\nmachine (VM).\n\nViewing logs on the VM instance\n-------------------------------\n\nYou can troubleshoot problems by looking at the Endpoints\nRuntime log on the VM instance.\n\nTo view the log:\n\n1. Use `ssh` to connect to your virtual machine:\n\n ```\n gcloud config set project YOUR_PROJECT_ID\n\n gcloud compute ssh INSTANCE_NAME\n ```\n\n Replace \u003cvar translate=\"no\"\u003eYOUR_PROJECT_ID\u003c/var\u003e and\n \u003cvar translate=\"no\"\u003eINSTANCE_NAME\u003c/var\u003e with your Google Cloud\n project ID and virtual machine instance name, respectively.\n2. View the `nginx` error log:\n\n If you are running endpoints-runtime on a raw VM: \n\n tail -f /var/log/nginx/error.log\n\n If you are running `endpoints-runtime` within Docker: \n\n ```\n docker ps\n\n docker logs CONTAINER_NAME\n ```\n\n Replace \u003cvar translate=\"no\"\u003eCONTAINER_NAME\u003c/var\u003e with the name of your\n container.\n\nDisplaying ESP status\n---------------------\n\nTo display ESP status:\n\n1. Use `ssh` to connect to your your virtual machine:\n\n ```\n gcloud config set project YOUR_PROJECT_ID\n\n gcloud compute ssh INSTANCE_NAME\n ```\n\n Replace \u003cvar translate=\"no\"\u003eYOUR_PROJECT_ID\u003c/var\u003e and\n \u003cvar translate=\"no\"\u003eINSTANCE_NAME\u003c/var\u003e with your\n Google Cloud project ID and virtual machine instance name, respectively.\n2. Retrieve the name of the ESP container (typically\n the container name is `esp`):\n\n docker ps\n\n3. Get a bash shell in the container:\n\n ```\n docker exec -it ESP_CONTAINER_NAME /bin/bash\n ```\n\n Replace \u003cvar translate=\"no\"\u003eESP_CONTAINER_NAME\u003c/var\u003e with the name of the\n ESP container from the previous step.\n4. Install [`curl`](https://curl.haxx.se/download.html).\n\n5. Enter the following:\n\n curl http://localhost:8090/endpoints_status\n\n### Getting the service configuration ID\n\nIf you set `rollout_strategy` to `managed` when you started ESP,\nand you need to find the configuration ID that an instance of\nESP is using, near the end of the output from the\n`curl http://localhost:8090/endpoints_status` command, the output is similar to\nthe following: \n\n \"serviceConfigRollouts\": {\n \"rolloutId\": \"2017-08-09r27\",\n \"percentages\": {\n \"2017-08-09r26\": \"100\"\n }\n }\n\nThe value in the `rolloutId` is the service configuration ID that\nESP is using. This configuration ID should match the latest deployed configuration.\nYou can view the deployment history on the **Endpoints** \\\u003e **Services** page in the\nGoogle Cloud console and view changes made to the service configuration. See\n[Comparing configuration files](/endpoints/docs/grpc/config-file-compare)."]]
