Apigee 및 Apigee Hybrid 플레이북 소개

ApigeeApigee Hybrid 문서입니다.
Apigee Edge 문서 보기

문제 해결은 예술이자 과학입니다. Apigee 기술 지원팀은 이러한 예술적인 과정의 비밀을 파헤치고 문제를 식별하고 해결하는 과정 이면의 과학적인 요소들을 드러내기 위해 지금까지 지속적으로 노력하고 있습니다.

플레이북이란 무엇인가요?

Apigee 기술 지원팀과의 협력에 따라 개발된 Apigee 문제 해결 플레이북은 Apigee 제품을 사용할 때 발생할 수 있는 오류 또는 기타 문제에 대해 빠르고 효과적인 솔루션을 제공할 수 있도록 디자인되었습니다.

대상

문제 해결 플레이북은 Apigee 및 아키텍처에 대한 이해 수준이 높은 독자와 정책 및 분석과 같은 기본 개념을 이해하고 있는 독자를 기준으로 작성되었습니다.

일부 문제는 Apigee Hybrid 사용자만 진단 및 해결할 수 있고, Cassandra 및 Postgres Datastore, 메시지 프로세서, 라우터 등의 내부 구성요소에 대한 지식이 필요할 수 있습니다.

Apigee를 사용하는 경우 표시된 문제 해결 단계를 수행할 수 있는 경우 및 지원을 받기 위해 Apigee 지원에 연락해야 하는 경우가 명확하게 표시되어 있습니다.

플레이북

이 섹션에서는 현재 플레이북에 대해 설명합니다.

이 표를 필터링하려면 카테고리 선택, 제품 선택, 검색어 입력 또는 열 제목을 클릭하여 정렬 중에서 하나 이상을 수행합니다.

카테고리 플레이북/문제 설명 오류 메시지 플레이북 적용 대상
Cassandra Cassandra 복원 문제 해결 Apigee Hybrid에서 Cassandra 복원 중에 복원 로그에 오류가 발생할 수 있습니다. Apigee Hybrid에만 해당
자동 문제 표시 런타임 영역과 제어 영역 사이에 네트워크 연결 없음

Apigee API 관리 요청 실패:

  • API 제품, 개발자, 앱이 Apigee UI에 채워지지 않습니다.
  • API 프록시 배포가 완료되지 않습니다.
  • Apigee API 관리 요청이 실패합니다.
Apigee Hybrid에만 해당
자동 문제 표시 환경 그룹이 누락된 가상 호스트 kubectl -n apigee get apigeeissues를 실행한 후 AIS_VIRTUALHOST_MISSING_ENVGROUP 오류가 표시됩니다. Apigee Hybrid에만 해당
자동 문제 표시 인그레스 인증서 불일치 kubectl -n apigee get apigeeissues를 실행하면 AIS_INGRESS_CERT_MISMATCH 오류가 표시됩니다. Apigee Hybrid에만 해당
Cassandra Cassandra 데이터 복제 실패 멀티 리전 확장 중에 데이터를 복제할 때 CassandraDataReplication 상태에 오류 상태가 표시되고 데이터 복제가 실패할 수 있습니다. 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 프록시 배포 실패 apigee-watcher 로그의 오류 메시지와 함께 API 프록시 배포가 실패합니다. 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에만 해당