Stay organized with collectionsSave and categorize content based on your preferences.
If you don't get a successful response from a request to your
Cloud Endpoints Frameworks API, you can use Cloud Logging in the
Google Cloud console to help troubleshoot.
Viewing logs
In the Google Cloud console, go to theLogging>Logs Explorerpage.
From the project drop-down list at the top of the page, select the
Google Cloud project in which you created your API.
SelectGAE ApplicationandAll logs.
Adjust the time range until you see a row that shows an error.
ClickExpand Allto see the entire log for the error.
The following section provides troubleshooting information for specific error
messages. If you are unable to fix the issue, copy one of the log entries that
shows the error and paste it in a text file. Include the log in any
communication that you have with Google.
503 Service Unavailable
App Engine might take a few minutes to respond successfully to requests. If you
send a request and get a503error, wait a few minutes and try the
request again. If you still don't get a successful response, check the
Cloud Logging logs. The following are some error messages that you might
see in the Cloud Logging logs.
Error message
Troubleshooting
No serviceYOUR_PROJECT_ID.appspot.comfound or
permission denied. If this is a new Endpoints service, make sure you've
deployed the service config using gcloud.
Endpoints Frameworks for Python logs this error when it fails to load
the service configuration for the service that you have specified in yourapp.yamlfile. This error can happen when you haven't deployed
the OpenAPI document for your API by usinggcloud endpoints services
deploy, or the Service Management API isn't enabled. When you deploy
the OpenAPI document for your API, thegcloudcommand
automatically enables the following:
Service Management API
(servicemanagement.googleapis.com)
Cloud APIs (cloudapis.googleapis.com)
If you have disabled any of these services, you must reenable them. SeeEnabling and disabling APIsfor
more information.
The serviceYOUR_PROJECT_ID.appspot.comwas found, but
no service config was found for versionSERVICE_CONFIG_ID.
Endpoints Frameworks for Python logs this error when it fails to
find the service configuration ID that you have specified forENDPOINTS_SERVICE_VERSIONin yourapp.yamlfile.
To fix this error:
Edit yourapp.yamlfile and setENDPOINTS_SERVICE_VERSIONto the service configuration ID.
Redeploy your app:
gcloudappdeploy
404 Not Found
If you recently migrated to Endpoints Frameworks version 2, and you
get the404 Not Founderror message, see the following sections to
troubleshoot the issue:
In some versions of Windows PowerShell, the exampleInvoke-WebRequestin thetutorialsfails. We have also received a
report that the response contained a list of unsigned bytes that had to be
converted to characters. If the exampleInvoke-WebRequestdidn't return the
expected result, try sending the request using another application. Following
are a few suggestions:
Start Cloud Shell, and follow the Linux
steps in the tutorial that you were using to send the request.
Use a third-party application such as the Chrome browser extension Postman
(offered bywww.getpostman.com). When creating the request in Postman:
SelectPOSTas the HTTP verb.
For the header, select the keycontent-typeand the valueapplication/json.
For the body, enter:{"message":"hello world"}
Enter the URL for the sample application. For example:
Download and installcurl, which you
run in the Command prompt. Because Windows doesn't handle double quotation
marks nested inside single quotation marks, you have to change the--dataoption in the example, as follows:--data "{\"message\":\"hello world\"}"
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eCloud Logging helps troubleshoot unsuccessful responses from Cloud Endpoints Frameworks APIs, accessible via the Logs Explorer in the Google Cloud console.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003e503 Service Unavailable\u003c/code\u003e error may occur initially with App Engine; waiting a few minutes and retrying the request is recommended before checking logs.\u003c/p\u003e\n"],["\u003cp\u003eErrors like "No service found" or "permission denied" often indicate a missing service configuration or disabled APIs, which can be resolved by deploying the OpenAPI document and ensuring necessary APIs are enabled.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003e404 Not Found\u003c/code\u003e error after migrating to Endpoints Frameworks version 2 requires specific troubleshooting steps detailed in Java and Python migration guides.\u003c/p\u003e\n"],["\u003cp\u003eIf \u003ccode\u003eInvoke-WebRequest\u003c/code\u003e fails in Windows PowerShell, try using Cloud Shell, Postman, or \u003ccode\u003ecurl\u003c/code\u003e with specific formatting for nested quotation marks.\u003c/p\u003e\n"]]],[],null,["# Troubleshooting response errors\n\nIf you don't get a successful response from a request to your\nCloud Endpoints Frameworks API, you can use Cloud Logging in the\nGoogle Cloud console to help troubleshoot.\n\nViewing logs\n------------\n\n1. In the Google Cloud console, go to the **Logging** \\\u003e\n **Logs Explorer** page.\n\n\n [Go to the Logs Explorer page](https://console.cloud.google.com/logs/query)\n\n \u003cbr /\u003e\n\n2. From the project drop-down list at the top of the page, select the\n Google Cloud project in which you created your API.\n\n3. Select **GAE Application** and **All logs**.\n\n4. Adjust the time range until you see a row that shows an error.\n\n5. Click **Expand All** to see the entire log for the error.\n\nThe following section provides troubleshooting information for specific error\nmessages. If you are unable to fix the issue, copy one of the log entries that\nshows the error and paste it in a text file. Include the log in any\ncommunication that you have with Google.\n\n### `503 Service Unavailable`\n\nApp Engine might take a few minutes to respond successfully to requests. If you\nsend a request and get a `503` error, wait a few minutes and try the\nrequest again. If you still don't get a successful response, check the\nCloud Logging logs. The following are some error messages that you might\nsee in the Cloud Logging logs.\n\n### `404 Not Found`\n\nIf you recently migrated to Endpoints Frameworks version 2, and you\nget the `404 Not Found` error message, see the following sections to\ntroubleshoot the issue:\n\n- [Java: Troubleshooting](/endpoints/docs/frameworks/java/migrating#api_returns_404_errors_but_api_explorer_still_lists_apis_correctly)\n- [Python: Troubleshooting](/endpoints/docs/frameworks/python/migrating#api_returns_404_errors_but_api_explorer_still_lists_apis_correctly)\n\nIssues with the example `Invoke-WebRequest`\n-------------------------------------------\n\nIn some versions of Windows PowerShell, the example `Invoke-WebRequest` in the\n[tutorials](/endpoints/docs/frameworks/tutorials) fails. We have also received a\nreport that the response contained a list of unsigned bytes that had to be\nconverted to characters. If the example `Invoke-WebRequest` didn't return the\nexpected result, try sending the request using another application. Following\nare a few suggestions:\n\n- [Start Cloud Shell](/shell/docs/starting-cloud-shell), and follow the Linux steps in the tutorial that you were using to send the request.\n- Use a third-party application such as the Chrome browser extension Postman\n (offered by `www.getpostman.com`). When creating the request in Postman:\n\n - Select `POST` as the HTTP verb.\n - For the header, select the key `content-type` and the value `application/json`.\n - For the body, enter: `{\"message\":\"hello world\"}`\n - Enter the URL for the sample application. For example:\n\n https://example-project-12345.appspot.com/_ah/api/echo/v1/echo\n\n- Download and install [`curl`](https://curl.haxx.se/download.html), which you\n run in the Command prompt. Because Windows doesn't handle double quotation\n marks nested inside single quotation marks, you have to change the `--data`\n option in the example, as follows: `--data \"{\\\"message\\\":\\\"hello world\\\"}\"`\n\nWhat's next\n\n- Get started using the [Logs Explorer](/logging/docs/view/logs-explorer-interface).\n\n- Learn how to [route logs](/logging/docs/export/configure_export_v2).\n\n- Use [filters](/logging/docs/view/advanced_filters)\n for advanced filtering, such as getting all requests with a latency greater\n than 300 milliseconds."]]