Go 1.11은 지원이 종료되었으며 2026년 1월 31일에
지원 중단됩니다. 지원 중단 후에는 조직에서 이전에 조직 정책을 사용하여 레거시 런타임의 배포를 다시 사용 설정한 경우에도 Go 1.11 애플리케이션을 배포할 수 없습니다. 기존 Go 1.11 애플리케이션은
지원 중단 날짜 이후에도 계속 실행되고 트래픽을 수신합니다.
지원되는 최신 Go 버전으로 마이그레이션하는 것이 좋습니다.
App Engine 오류 문제 해결
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 페이지에서는 App Engine을 사용하는 동안 발생할 수 있는 오류의 문제 해결 절차를 설명합니다. Google Cloud서비스에 영향을 미치는 사고에 대한 자세한 내용은 Google Cloud Service Health 대시보드 및 App Engine에 대해 보고된 모든 사고를 참조하세요.
앱과 관련된 문제를 해결하는 방법에 관한 안내는 다음 페이지를 참조하세요.
App Engine 문제 해결 전략
다음 섹션에서는 일반적인 문제 해결 전략을 적용하여 오류를 해결하는 방법을 설명합니다. 문제 해결 가이드의 단계를 따르고도 오류가 계속 발생하면 다음 단계를 참고하세요.
Cloud Logging을 사용하여 유효한 로그 출력
디버깅을 위한 유효한 애플리케이션 로그가 있으면 App Engine에서 실행되는 앱을 더 쉽게 해결할 수 있습니다. 애플리케이션이 요청 로그와 애플리케이션 로그를 연결하는 방식으로 로그를 작성하는지 확인합니다.
상관관계가 지정된 로그를 사용하면 추가 분석이 필요한 요청을 식별하고, 요청 트레이스를 찾고, 문제의 근본 원인을 분석할 수 있습니다. 로그 작성에 관한 자세한 내용은 애플리케이션 로그 작성을 참조하세요.
예기치 않은 지연 시간 해결
지연 시간 문제가 발생하면 다음 단계를 따르세요.
지연 시간이 서비스의 모든 요청에 영향을 미치는지 아니면 일부 요청에만 영향을 미치는지 확인합니다. App Engine 지연 시간 대시보드에는 50번째, 95번째, 99번째 백분위수 지연 시간이 표시됩니다.
세 가지 측정항목 모두에서 지연 시간이 길면 요청의 50% 이상에서 지연 시간이 긴 것입니다. 99번째 백분위수 그래프에만 지연 시간이 긴 경우 요청의 1%에서 지연 시간이 긴 것입니다.
지연 시간이 긴 요청을 식별하여 지연 시간의 원인을 파악합니다. Cloud Trace 또는 Cloud Logging을 사용하여 특정 요청에 걸린 시간을 파악할 수 있습니다. 자세한 내용은 앱 지연 시간 이해하기를 참조하세요.
Cloud Logging을 사용하여 지연 시간이 긴 요청을 식별하려면 traceSampled=true 필터를 적용하여 Cloud Logging의 로그를 Cloud Trace의 trace와 연결합니다. 자세한 내용은 Cloud Logging과 통합을 참조하세요.
지연 시간 문제를 해결하고 서비스 성능을 개선하려면 다음 단계를 따르세요.
프로파일러를 사용해 보세요.
소스 코드를 수정합니다.
지연 시간 증가 문제를 해결하는 방법에 관한 자세한 내용은 앱의 지연 시간 증가 문제 해결을 참조하세요.
연결 문제 해결
기본적으로 App Engine 서비스는 공개 인터넷에서 액세스할 수 있지만, 서비스의 인그레스 및 이그레스 네트워크 연결에 더 많은 제한을 적용하도록 수정할 수 있습니다.
인그레스 설정 또는 App Engine 방화벽 규칙을 통해 인그레스 연결을 제한할 수 있습니다. VPC 네트워크 또는 인터넷 리소스에서 App Engine 서비스에 연결하는 데 문제가 있는 경우 다음을 확인하세요.
다른 연결 문제를 해결하려면 다음 단계를 따르세요.
네트워크 연결 테스트를 실행합니다.
VPC 네트워크로의 트래픽 이그레스 문제를 해결하려면 VPC 네트워크 방화벽 규칙을 확인하거나 클라이언트에서 연결 풀링을 사용하세요. 자세한 내용은 방화벽 규칙을 참조하세요.
기준점을 초과하는 더 많은 서비스와 연결로 VPC 커넥터가 과부하되지 않도록 합니다. 처리량을 개선하려면 커넥터의 VPC 커넥터 크기와 인스턴스 수를 고려하세요. 자세한 내용은 서버리스 VPC 액세스를 참조하세요.
VPC 리소스에 액세스하는 데 문제가 있는 경우 VPC 커넥터 처리량 차트를 검토하세요.
연결 문제를 해결하는 방법에 관한 자세한 내용은 App Engine 연결 전략을 참조하세요.
다음 단계
App Engine 문서에서 문제의 해결 방법을 찾을 수 없는 경우 다음 단계를 따르세요.
자세한 내용은 App Engine 커뮤니티를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-09-04(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[[["\u003cp\u003eThis page provides troubleshooting guidance for errors encountered while using App Engine, along with links to relevant Google Cloud health and incident reports.\u003c/p\u003e\n"],["\u003cp\u003eTroubleshooting guides are available for common issues such as deployment, serving, and elevated latency.\u003c/p\u003e\n"],["\u003cp\u003eEffective logging, including correlating request and application logs, is crucial for debugging App Engine applications.\u003c/p\u003e\n"],["\u003cp\u003eLatency issues can be diagnosed by examining request metrics and utilizing tools like Cloud Trace and Cloud Logging, and fixed by adjusting instance classes, warmup requests, scaling settings, or code modification.\u003c/p\u003e\n"],["\u003cp\u003eConnectivity problems can be resolved by reviewing ingress settings, firewall rules, running network tests, and managing VPC connector configurations.\u003c/p\u003e\n"]]],[],null,["# Troubleshoot App Engine errors\n\nThis page describes the troubleshooting process for errors you might encounter while\nusing App Engine. For information about incidents affecting Google Cloud\nservices, refer to the [Google Cloud Service Health Dashboard](https://status.cloud.google.com/summary) and [All incidents reported for App Engine](https://status.cloud.google.com/products/kchyUtnkMHJWaAva8aYc/history).\n\nSee the following pages for guidance on how to resolve issues related to your app:\n\n- [Troubleshoot deployment issues](/appengine/docs/standard/troubleshooter/deployment)\n- [Troubleshoot serving issues](/appengine/docs/standard/troubleshooter/serving)\n- [Troubleshoot elevated latency in your app](/appengine/docs/standard/troubleshooter/latency)\n- [App Engine connectivity strategies](/appengine/docs/standard/troubleshooter/connectivity)\n\nApp Engine troubleshooting strategies\n-------------------------------------\n\nThe following sections explain how you can apply general troubleshooting\nstrategies to resolve your error. If you continue to encounter errors\neven after following the steps in the troubleshooting guides, see [What's next](#whats-next).\n\n### Output good logs using Cloud Logging\n\nTroubleshooting your app running on App Engine is easier if you have good\napplication logs for debugging. Ensure your application writes logs in a way that\n[correlates request logs with the application logs](/appengine/docs/standard/writing-application-logs#correlate_logs).\n\nWith correlated logs you can identify the request that needs further analysis,\nfind the request trace, and analyze the root cause of the issue. For more\ninformation on writing logs, see [Write application logs](/appengine/docs/standard/writing-application-logs#writing_app_logs).\n\n### Resolve unexpected latency\n\nIf you encounter issues with latency, do the following:\n\n1. Check if the latency is affecting all requests to your service or only a\n small percentage. The [App Engine latency dashboard](/appengine/docs/standard/monitoring-and-alerting-latency#checking_the_latency_dashboard) shows 50th,\n 95th, and 99th percentile latency.\n\n If you have high latency on all three of these metrics, you have high latency\n for at least 50% of your requests. If you only see high latency in the\n 99th percentile graph, you have high latency in 1% of your requests.\n2. Identify the request with high latency to understand the source of\n latency. You can use Cloud Trace or Cloud Logging to understand how\n long a particular request has taken. For more information, see [Understanding app latency](/appengine/docs/standard/monitoring-and-alerting-latency#understanding_app_latency).\n\n To identify requests with high latency using Cloud Logging, apply the `traceSampled=true` filter to correlate logs in Cloud Logging with traces in Cloud Trace. For more information, see [Integrate with Cloud Logging](/trace/docs/trace-log-integration).\n3. Try the following steps to fix latency issues, and improve service performance:\n\n - Increase the [instance class](/appengine/docs/standard#instance_classes) settings.\n\n - Reduce cold start latency by [configuring warmup requests](/appengine/docs/standard/configuring-warmup-requests).\n\n - Adjust [scaling settings](/appengine/docs/standard/how-instances-are-managed#scaling_dynamic_instances).\n\n \u003c!-- --\u003e\n\n - Consider using [Profiler](/appengine/docs/standard/cloud-profiler).\n\n - Modify your source code.\n\nFor more information on how to troubleshoot elevated latency issues, see [Troubleshoot elevated latency in your app](/appengine/docs/standard/troubleshooter/latency).\n\n### Resolve issues with connectivity\n\nBy default, your App Engine service is accessible on the public internet, however,\nyou can modify the service to have more restrictions on ingress and egress\nnetwork connectivity.\n\nYou can restrict ingress connections with the ingress settings, or through App Engine firewall rules. If you have trouble connecting to your App Engine service from\nVPC networks or internet resources, check the following:\n\n- [Ingress settings](/appengine/docs/standard/ingress-settings)\n- [App Engine firewall](/appengine/docs/standard/understanding-firewalls)\n\nTo resolve other connectivity issues, do the following:\n\n- Run a [network connectivity test](/network-intelligence-center/docs/connectivity-tests/how-to/running-connectivity-tests#console_6).\n\n- To resolve problems with traffic egress to a VPC network, check the VPC network\n firewall rules or use connection pooling in your client. For more information,\n see [Firewall rules](/vpc/docs/serverless-vpc-access#connector-fw-rules-standalone-vpc-or-host-prj).\n\n- Ensure that you aren't [overloading your VPC connector](/appengine/docs/standard/connecting-vpc#network-cpu) with more services and\n connections beyond its threshold. To improve throughput, consider the VPC connector\n size and instance count for your connectors. For more information, see\n [Serverless VPC Access](/vpc/docs/serverless-vpc-access#scaling).\n\n- For problems accessing VPC resources, review the [VPC connector throughput charts](/vpc/docs/serverless-vpc-access#throughput_chart).\n\nFor more information on how to troubleshoot connectivity issues, see\n[App Engine connectivity strategies](/appengine/docs/standard/troubleshooter/connectivity).\n\n### What's next\n\nIf you can't find a solution to your problem in the App Engine\ndocumentation, follow these steps:\n\n- Open a support case by contacting [Cloud Customer Care](/support-hub).\n- Get support from the community by [asking questions on StackOverflow](https://stackoverflow.com/questions/tagged/google-app-engine), or search for similar issues using the `google-app-engine` tag.\n- Open bugs or feature requests by using the [public issue tracker](/support/docs/issue-trackers).\n\nFor more information, see [App Engine community](/appengine/docs/standard/community)."]]
