En esta página se describen técnicas para solucionar problemas cuando se implementa Extensible Service Proxy (ESP) en una máquina virtual de Compute Engine.
Ver registros en la instancia de VM
Para solucionar problemas, puedes consultar el registro de tiempo de ejecución de los endpoints en la instancia de VM.
Para ver el registro:
Usa ssh para conectarte a tu máquina virtual:
gcloud config set project YOUR_PROJECT_ID
gcloud compute ssh INSTANCE_NAME
Sustituye YOUR_PROJECT_ID y INSTANCE_NAME por el ID de tu proyecto y el nombre de la instancia de máquina virtual, respectivamente. Google Cloud
Para ver el registro de errores de nginx, sigue estos pasos:
Si ejecutas endpoints-runtime en una máquina virtual sin formato:
tail-f/var/log/nginx/error.log
Si ejecutas endpoints-runtime en Docker:
docker ps
docker logs CONTAINER_NAME
Sustituye CONTAINER_NAME por el nombre de tu contenedor.
Mostrar el estado de un ESP
Para mostrar el estado del ESP, sigue estos pasos:
Usa ssh para conectarte a tu máquina virtual:
gcloud config set project YOUR_PROJECT_ID
gcloud compute ssh INSTANCE_NAME
Sustituye YOUR_PROJECT_ID y INSTANCE_NAME por el ID de tu proyecto y el nombre de la instancia de máquina virtual, respectivamente.Google Cloud
Recupera el nombre del contenedor ESP (normalmente, el nombre del contenedor es esp):
docker ps
Obtén un shell bash en el contenedor:
docker exec -it ESP_CONTAINER_NAME /bin/bash
Sustituye ESP_CONTAINER_NAME por el nombre del contenedor del ESP del paso anterior.
Si has definido rollout_strategy en managed al iniciar ESP y necesitas encontrar el ID de configuración que está usando una instancia de ESP, cerca del final del resultado del comando curl http://localhost:8090/endpoints_status, el resultado será similar al siguiente:
El valor de rolloutId es el ID de configuración del servicio que usa ESP. Este ID de configuración debe coincidir con la última configuración implementada.
Puedes ver el historial de implementaciones en la página Endpoints > Services (Endpoints > Servicios) de la consola Google Cloud y ver los cambios realizados en la configuración del servicio. Consulta Comparar archivos de configuración.
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Es difícil de entender","hardToUnderstand","thumb-down"],["La información o el código de muestra no son correctos","incorrectInformationOrSampleCode","thumb-down"],["Me faltan las muestras o la información que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-11 (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)."]]
