Apigee 및 Apigee Hybrid 문서입니다.
Apigee Edge 문서 보기
문제 해결은 예술이자 과학입니다. Apigee 기술 지원팀은 이러한 예술적인 과정의 비밀을 파헤치고 문제를 식별하고 해결하는 과정 이면의 과학적인 요소들을 드러내기 위해 지금까지 지속적으로 노력하고 있습니다.
플레이북이란 무엇인가요?
Apigee 기술 지원팀과의 협력에 따라 개발된 Apigee 문제 해결 플레이북은 Apigee 제품을 사용할 때 발생할 수 있는 오류 또는 기타 문제에 대해 빠르고 효과적인 솔루션을 제공할 수 있도록 디자인되었습니다.
대상
문제 해결 플레이북은 Apigee 및 아키텍처에 대한 이해 수준이 높은 독자와 정책 및 분석과 같은 기본 개념을 이해하고 있는 독자를 기준으로 작성되었습니다.
일부 문제는 Apigee Hybrid 사용자만 진단 및 해결할 수 있고, Cassandra 및 Postgres Datastore, 메시지 프로세서, 라우터 등의 내부 구성요소에 대한 지식이 필요할 수 있습니다.
Apigee를 사용하는 경우 표시된 문제 해결 단계를 수행할 수 있는 경우 및 지원을 받기 위해 Google Cloud Customer Care에 연락해야 하는 경우가 명확하게 표시되어 있습니다.
플레이북
이 섹션에서는 현재 플레이북에 대해 설명합니다.
이 표를 필터링하려면 카테고리 선택, 제품 선택, 검색어 입력 또는 열 제목을 클릭하여 정렬 중에서 하나 이상을 수행합니다.
| 카테고리 | 플레이북/문제 설명 | 오류 메시지 | 플레이북 적용 대상 |
|---|---|---|---|
| Cassandra | Cassandra 복원 문제 해결 | Apigee Hybrid에서 Cassandra 복원을 수행하는 동안 복원 로그에 오류가 표시될 수 있습니다. | Apigee Hybrid에만 해당 |
| 자동 문제 표시 | 런타임 영역과 제어 영역 사이에 네트워크 연결 없음 | Apigee API 관리 요청 실패:
|
Apigee Hybrid에만 해당 |
| 자동 문제 표시 | 환경 그룹이 누락된 가상 호스트 | kubectl -n apigee get apigeeissues를 실행하면 AIS_VIRTUALHOST_MISSING_ENVGROUP 오류가 표시됩니다.
|
Apigee Hybrid에만 해당 |
| 자동 문제 표시 | 선택기가 누락된 가상 호스트 | kubectl -n apigee get apigeeissues를 실행하면 AIS_VIRTUALHOST_MISSING_SELECTOR 오류가 표시됩니다.
|
Apigee Hybrid에만 해당 |
| 자동 문제 표시 | 인그레스 인증서 불일치 | kubectl -n apigee get apigeeissues를 실행하면 AIS_INGRESS_CERT_MISMATCH 오류가 표시됩니다.
|
Apigee Hybrid에만 해당 |
| 자동 문제 표시 | 인그레스 인증서 만료 | kubectl -n apigee get apigeeissues를 실행하면 AIS_INGRESS_CERT_EXPIREY 오류가 표시됩니다. |
Apigee Hybrid에만 해당 |
| 자동 문제 표시 | 인그레스 mTLS CA 인증서 만료 | kubectl -n apigee get apigeeissues를 실행하면 AIS_INGRESS_MTLS_CA_CERT_EXPIREY 오류가 표시됩니다.
|
Apigee Hybrid에만 해당 |
| 자동 문제 표시 | 인그레스 mTLS CA 인증서가 잘못됨 | kubectl -n apigee get apigeeissues를 실행하면 AIS_INGRESS_MTLS_CA_CERT_INVALID 오류가 표시됩니다.
|
Apigee Hybrid에만 해당 |
| Cassandra | Cassandra 데이터 복제 실패 |
멀티 리전 확장 중에 데이터를 복제할 때 CassandraDataReplication 상태에 오류 상태가 표시되고 데이터 복제가 실패할 수 있습니다.
|
Apigee Hybrid에만 해당 |
| Cassandra | Cassandra Java 힙 공간 문제 |
Cassandra 힙 문제로 인해 Apigee Hybrid 프록시 실행 속도가 느려지거나 Datastore 오류가 발생할 수 있습니다. 증상이 나타나기 전이더라도 로그가 조기 지표가 되는 경우가 있습니다.
|
Apigee Hybrid에만 해당 |
| Cassandra | 보조 리전에서 시작되지 않는 Cassandra 포드 |
Cassandra 포드가 멀티 리전 하이브리드 설정의 리전 중 하나에서 시작할 때 오류가 발생합니다.
Cassandra Pod 로그에 node already exists 오류 메시지가 표시되거나 Cassandra Pod 상태에 FailedPreStopHook 경고가 표시될 수 있습니다.
|
Apigee Hybrid에만 해당 |
| Cassandra | Cassandra 문제 해결 가이드 |
kubectl을 사용하여 Pod 상태를 보면 하나 이상의 Cassandra 포드가 멈춰 있습니다. 이 가이드에서는 Cassandra Datastore의 문제에 대한 진단 및 해결 방법을 설명합니다.
|
Apigee Hybrid에만 해당 |
| 배포 | 활성 런타임 포드 없음 경고가 표시되면서 API 프록시 배포 실패 | API 프록시 페이지의 ENVIRONMENT: REVISION_NUMBER에서 배포 문제 오류 메시지 옆에 있는 세부정보 대화상자에 활성 런타임 pod 없음 경고가 표시됩니다. | Apigee Hybrid에만 해당 |
| Ingressgateway | 시간 초과 오류로 API 호출 실패 |
curl: (7) Failed to connect to example.apis.com port 443: Operation timed out |
Apigee Hybrid에만 해당 |
| Ingressgateway | TLS 오류로 API 호출 실패 |
curl: (35) LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to example.apis.com:443 |
Apigee Hybrid에만 해당 |
| 로깅 | Cloud Logging에서 Apigee 로그 누락 문제 해결 | 이 시나리오에서는 표시되도록 알려진 오류 메시지가 없습니다. | Apigee 및 Apigee Hybrid |
| 관리/UI | 하이브리드 UI 또는 관리 API에서 항목에 대해 일치하지 않는 데이터가 관측되거나 데이터가 관측되지 않음 | 이 시나리오에서는 표시되도록 알려진 오류 메시지가 없습니다. | Apigee Hybrid에만 해당 |
| 네트워크 구성 | Apigee의 액세스 라우팅 문제 |
외부 클라이언트는 원하는 방식으로 Apigee에 액세스하거나 연결할 수 없습니다. 여기에는 네트워크 연결 실패(TLS 핸드셰이크 실패) 또는 Apigee의 4xx/5xx 응답이 포함됩니다.
|
Apigee 및 Apigee Hybrid |
| 네트워크 구성 | Southbound PSC 대상과의 Apigee 연결 문제 |
Apigee와 대상 서비스 간의 네트워크 연결 문제 또는 TCP 시간 초과 시 503 오류 응답이 표시되고 디버그 세션을 만들 경우 아래와 유사한 오류가 표시됩니다.
{"fault":{"faultstring":"The Service is temporarily unavailable","detail":{"errorcode":"messaging.adaptors.http.flow.ServiceUnavailable","reason":"TARGET_CONNECT_TIMEOUT"}}}
|
Apigee 및 Apigee Hybrid |
| 기타 | 노드 드레이닝 시 Istio 속성 복제본 수 확장 | Istio 포드를 드레이닝할 때 일부 노드에는 복제본이 1개이지만 복제본이 3개 이상 필요하므로 일부 노드가 드레이닝되지 않을 수 있습니다. 이를 방지하려면 속성마다 최소 복제본 수를 최소 3개 이상으로 설정해야 합니다. | Apigee Hybrid에만 해당 |
| 기타 | 메시지 프로세서 문제 해결 가이드 |
하나 이상의 apigee-runtime 포드가 Ready 상태가 아닙니다.
kubectl을 사용하여 실패한 apigee-runtime 포드를 설명하면 다음 오류가 표시됩니다.
Readiness probe failed: HTTP probe failed with statuscode: 500 |
Apigee Hybrid에만 해당 |
| 기타 | 빌드 정보 인쇄 |
buildinfo API는 런타임 구성요소의 현재 빌드에 대한 정보를 반환합니다. 이 정보는 지원팀에 문의해야 할 경우 유용할 수 있습니다.
|
Apigee Hybrid에만 해당 |
| 기타 | StreamingPull 오류 100% |
측정항목 대시보드에서 google.pubsub.vl.Subscriber.StreamingPull 메서드가 100% 오류로 실패하는 경우 문제를 무시해도 안전합니다. 이는 정상적인 동작입니다.
|
Apigee Hybrid에만 해당 |
| 배포 | 인스턴스가 환경 그룹의 상태를 보고하지 않음 | API 프록시 배포가 실패하고 INSTANCE_NAME 인스턴스가 Apigee Hybrid UI에서 환경 그룹 ENV_GROUP_NAME 오류 상태를 보고하지 않습니다. | Apigee Hybrid에만 해당 |
| 배포 | apigee-serving-cert를 찾을 수 없거나 만료되어 API 프록시 배포 실패 |
API 프록시 배포가 실패하고 apigee-watcher 로그에 오류 메시지가 표시됩니다.
|
Apigee Hybrid에만 해당 |
| Ingressgateway | Istio 노드 드레이닝 시 문제를 방지하도록 Istio 속성 복제본 수 확장 |
Istio 포드를 드레이닝할 때 일부 노드에는 복제본이 1개이지만 복제본이 3개 이상 필요하므로 일부 노드가 드레이닝되지 않을 수 있습니다. 이를 방지하려면 속성마다 최소 복제본 수를 최소 3개 이상으로 설정해야 합니다.
|
Apigee Hybrid에만 해당 |
| 네트워크 구성 | IP 주소 여유 공간 없음 문제 해결 | Apigee 프로비저닝 중에 완전히 비어 있지 않은 네트워크 CIDR 범위를 선택하면 오류 메시지가 표시될 수 있습니다. | Apigee 및 Apigee Hybrid |
| 네트워크 구성 | TARGET_CONNECT_TIMEOUT과 함께 VPC 피어링 503 서비스를 사용할 수 없음 오류 | 이 문서에서는 VPC 피어링을 사용할 때 TARGET_CONNECT_TIMEOUT과 함께 '503 서비스를 사용할 수 없음' 오류를 진단하고 수정하는 방법을 설명합니다. | Apigee |
| 네트워크 구성 | 504 게이트웨이 시간 초과 - 대상 읽기 시간 제한 | 이 문서에서는 TARGET_READ_TIMEOUT 이유와 함께 '504 게이트웨이 시간 초과' 오류를 진단하고 수정하는 방법을 설명합니다. | Apigee 및 Apigee Hybrid |
| 기타 | Apigee Hybrid가 생성 또는 출시 상태에서 멈추는 문제 해결 | 이 문서에서는 Apigee Hybrid 구성요소가 creating 또는 releasing 상태에서 중단된 경우 이 구성요소를 재설정하는 방법을 설명합니다. |
Apigee Hybrid에만 해당 |