En esta página, se muestran las técnicas de solución de problemas que se aplican cuando se implementa el proxy de servicio extensible (ESP) en una máquina virtual (VM) de Compute Engine.
Visualiza registros en la instancia de VM
Puedes solucionar problemas observando el registro de Endpoints Runtime en la instancia de VM.
Para ver el registro, sigue estos pasos:
Usa ssh para conectarte a tu máquina virtual de la siguiente manera:
gcloud config set project YOUR_PROJECT_ID
gcloud compute ssh INSTANCE_NAME
Reemplaza YOUR_PROJECT_ID y INSTANCE_NAME por el ID de tu proyecto de Google Cloudy el nombre de la instancia de máquina virtual, respectivamente.
Visualiza el registro de errores de nginx:
Si ejecutas endpoints-runtime en una VM sin procesar, haz lo siguiente:
tail-f/var/log/nginx/error.log
Si ejecutas endpoints-runtime dentro de Docker, haz lo siguiente:
docker ps
docker logs CONTAINER_NAME
Reemplaza CONTAINER_NAME con el nombre de tu contenedor.
Muestra el estado del ESP
Para mostrar el estado del ESP, haz lo siguiente:
Usa ssh para conectarte a tu máquina virtual:
gcloud config set project YOUR_PROJECT_ID
gcloud compute ssh INSTANCE_NAME
Reemplaza YOUR_PROJECT_ID y INSTANCE_NAME por el ID de tu proyecto deGoogle Cloud y el nombre de la instancia de máquina virtual, respectivamente.
Recupera el nombre del contenedor del ESP (por lo general, el nombre del contenedor es esp):
docker ps
Obtén un shell Bash en el contenedor con el comando siguiente:
docker exec -it ESP_CONTAINER_NAME /bin/bash
Reemplaza ESP_CONTAINER_NAME con el nombre del contenedor del ESP del paso anterior.
Si configuraste rollout_strategy como managed cuando inicias el ESP, y necesitas encontrar el ID de configuración que usa una instancia de ESP, cerca del final del resultado del comando curl http://localhost:8090/endpoints_status, el resultado es similar al siguiente:
El valor en rolloutId es el ID de configuración de servicio que ESP usa. Este ID debería coincidir con la configuración que se implementó más recientemente.
Puedes ver el historial de implementaciones en la página Endpoints > Services en la consola de Google Cloud y ver los cambios realizados en la configuración del servicio. Consulta Comparar archivos de configuración.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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)."]]