Apigee에서 알려진 문제

이 페이지는 ApigeeApigee Hybrid에 적용됩니다.

Apigee Edge 문서 보기

이 페이지를 필터링하려면 다음 중 하나 이상을 선택합니다.

이 섹션에는 Apigee 구성요소에서 알려진 문제가 나열되어 있습니다. 버그 목록, 새로운 기능, 기타 출시 정보는 출시 노트를 참조하세요.

문제 ID 영향 상태 설명

해당 사항 없음

Apigee Hybrid 미해결 잘못된 서비스 계정에서 UpdateControlPlaneAccess API를 재시도 루프로 전송할 수 있습니다.

사용자가 잘못된 서비스 계정을 UpdateControlPlaneAccess API에 제공하면 작업이 재시도 루프로 전환되어 작업이 타임아웃될 때까지 조직이 API를 호출하지 못하도록 효과적으로 잠깁니다.

해당 사항 없음

Apigee Hybrid 미해결 apigee-logger 구성요소는 워크로드 아이덴티티 제휴를 지원하지 않습니다.

apigee-logger는 Cloud Logging으로 로그를 전송하기 위해 Google IAM 서비스 계정을 활용합니다. 이는 FluentBit에서 워크로드 아이덴티티 제휴를 지원하지 않아 apigee-logger에서 이 기능을 활용할 수 없기 때문입니다.

해당 사항 없음

Apigee Hybrid 미해결 Apigee Hybrid의 분산 Trace는 데이터 상주를 사용하는 조직에 지원되지 않습니다.

해당 사항 없음

Apigee 미해결 Apigee는 키 재암호화를 지원하지 않습니다. 즉, 순환 후에도 이전 키 버전이 계속 사용되며 조직을 만든 후에는 CMEK 키를 변경할 수 없습니다.

354716994

Apigee 미해결 Apigee는 Cloud 외부 키 관리자를 지원하지 않습니다.

364872027

Apigee
Apigee Hybrid
미해결 비표준 형식으로 인해 JWT/JWS 정책에서 PEM 파싱 오류 발생

Apigee 및 Apigee Hybrid 버전 1.13 이상에서 Apigee JWS 또는 JWT 정책에 사용되는 키가 필수 PEM 형식이 아니면 파싱 오류가 발생할 수 있습니다. 예를 들어 "-----END" 줄(캡슐화 후 경계) 바로 앞에 줄바꿈(/n)이 아닌 문자를 배치할 수 없으며 배치하면 오류가 발생합니다.

이 오류를 방지하려면 줄바꿈 이외의 문자(예: 후행 공백 또는 슬래시)가 캡슐화 후 경계 바로 앞에 있지 않도록 해야 합니다.

공개 키 또는 비공개 키에 사용되는 인코딩에 관한 자세한 내용은 IETF RFC 7468을 참고하세요.

310191899

Apigee
Apigee Hybrid
미해결 API 프록시 및 공유 흐름 배포 시 시간 초과

초당 쿼리 수(QPS)가 많은 경우 다음 엔드포인트에서 시간 초과가 발생할 수 있습니다.

시간 초과 가능성을 줄이려면 이러한 엔드포인트를 사용할 때 타겟 QPS를 3으로 설정하는 것이 좋습니다.

329304975

Apigee 해결됨 환경당 기본 경로 수 제한

Apigee는 API 프록시 버전을 배포할 때 발생할 수 있는 실패를 방지하기 위해 환경당 기본 경로 1,000개로 임시 제한을 적용하고 있습니다.

이 제한이 적용되는 동안 환경당 최대 1,000개의 API 프록시 버전(각각 단일 기본 경로 포함)을 배포할 수 있습니다. API 프록시 또는 버전에 기본 경로가 두 개 이상 포함된 경우 환경당 총 기본 경로 수가 1,000개를 초과할 수 없습니다.

333791378

Hybrid 1.12.0 미해결 Helm 마이그레이션 도구에서 지원하지 않는 Cassandra 백업 및 복원 기능

문제 해결을 위해 패치를 설치하는 데 필요한 단계는 문제 해결을 참조하세요.

310384001

Hybrid 1.11.0 미해결 사용자가 TLS 대상 엔드포인트 인증서의 기본 유효성 검사를 위해 대상 <SSLInfo> 블록에 <Enforce>true</Enforce> 태그를 추가하면 인증서 유효성 검사 실패가 503 오류 응답 대신 502를 반환할 수 있습니다.

289583112

Apigee 미해결 OASValidation 정책이 OpenAPI 사양의 전역 보안 요구사항에서 작동하지 않음

OASValidation 정책이 전역 수준에서 설정된 보안 요구사항으로 <OASResource>를 지정하면 보안 요구사항이 시행되지 않습니다.

해결 방법: 시행하려면 모든 보안 요구사항이 OASValidation 정책의 <OASResource> 요소에 전달된 OpenAPI 사양의 작업 수준에서 설정되어야 합니다.

205666368

Apigee
Hybrid 1.10.2
Hybrid 1.10.3
Apigee 1-10-0-apigee-6 및
Hybrid 1.10.3-hotfix.1에서 해결됨
Apigee Hybrid는 기본적으로 대상 인증서를 검증하지 않습니다.

대상 엔드포인트 또는 대상 서버의 TLS 옵션 설정 정보를 참조하세요.

295929616

Hybrid 1.10.0 이상 Hybrid 1.10.3에서 해결됨 OpenShift(OSE)에 Apigee Hybrid 1.10을 설치하면 메모리 부족 오류로 실패할 수 있습니다.

메모리 부족 문제로 인해 OSE에서 Apigee Hybrid 1.10.0~1.10.2를 설치하거나 업그레이드할 수 없습니다. Apigee Hybrid 버전 1.10.3에서 해결되었습니다.

292268968

Hybrid 1.10.1 미해결 apigee-udca가 HTTP 프록시 설정을 따르지 않을 수 있습니다.

방화벽이 전달 프록시를 통해 모든 트래픽을 강제 적용하면 apigee-udca가 비정상 종료 루프 백오프 상태가 될 수 있습니다.

269573358

Apigee
Hybrid 1.8.0 이상
미해결 OASValidation 정책이 Unable to parse JSON 오류와 함께 실패합니다.
  • JSON 콘텐츠가 예상 패턴과 일치하지 않으면 OASValidation 정책이 실패합니다. 예를 들어 헤더에 <text>@<text> 형식의 값이 필요하며 @ 기호가 없는 텍스트로 채워지면 정책이 Unable to parse JSON 오류와 함께 실패합니다.
  • OASValidation 정책에서 $ref 스키마를 활용하는 path 매개변수를 포함하는 <OASResource>를 지정하면 정책이 Unable to parse JSON - Unrecognized token 오류와 함께 실패합니다.

    해결 방법: <OASResource> 요소에 지정된 OpenAPI 사양의 path 매개변수에 $ref를 사용하지 마세요.

299953958

Apigee
Hybrid 1.8.0 이상
미해결 순환 참조를 사용하는 동안 OAS 유효성 검사 관련 배포 문제가 발생합니다.
  • OpenAPI 3.0.0 사양에 대한 순환 참조를 사용하면 무한 루프에 도달하기 때문에 OAS 유효성 검사 정책에 대해 Apigee 배포가 실패합니다.
  • 해결 방법: 순환 참조 없이 OpenAPI 사양 yaml을 사용합니다.

289254725

Apigee
Apigee 1-10-0-apigee-3
hybrid 1.8.8
hybrid 1.9.3
Apigee 1-10-0-apigee-5에서 해결됨
hybrid에서 미해결
OASValidation 정책이 포함된 프록시 배포가 실패할 수 있습니다.

OASValidation 정책이 포함된 프록시 배포가 실패할 수 있습니다.

  • OASValidation 정책에서 유효성 검사에 사용되는 OpenAPI 사양은 YAML 형식입니다.
  • YAML 형식의 OpenAPI 사양에 부동 소수점 수가 포함되어 있습니다. 예를 들면 다음과 같습니다.
    schema:
    type: number
    example: 2.345

284500460

Apigee
Apigee 1-10-0-apigee-1
해결됨 Cloud Logging과 함께 사용할 경우 메시지 로깅 정책의 지연 시간 증가

클라이언트에 대한 응답에서 지연 시간이 늘어나지 않도록 Message Logging 정책은 PostClientFlow에 연결되어야 합니다. PostClientFlow에서 정책을 사용하는 방법에 대한 자세한 내용은 흐름을 통한 API 프록시 제어를 참조하세요.

282997216

Hybrid 1.8.0 이상
Hybrid 1.9.0 이상
미해결 Cassandra Jolokia 비밀번호에 허용되지 않는 특수문자

Cassandra Jolokia 비밀번호에는 영숫자 문자만 사용합니다. 특수 문자(예: '!', '@', '#', '$', '%', '^', '&', '*')를 사용하면 Cassandra 시작이 실패합니다.

271415351

Apigee 미해결 동시 API 프록시 또는 SharedFlow 배포 방지

SharedFlow 또는 API 프록시에 대한 동시 배포 요청은 관리 서버에서 여러 버전이 배포된 것으로 표시되는 일관되지 않은 상태가 발생할 수 있습니다. 예를 들어 다른 버전을 사용하여 CI/CD 배포 파이프라인의 동시 실행이 실행되는 경우 이런 문제가 발생할 수 있습니다. 이 문제를 방지하려면 현재 배포가 완료되기 전에 API 프록시 또는 SharedFlow를 배포하지 마세요.

271689008

Hybrid 1.9.0 이상 미해결 OpenShift 버전 4.7~4.10의 cert-manager 포드가 예상대로 시작되지 않음

OpenShift 버전 4.7~4.10의 cert-manager v1.10.1을 사용하면 cert-manager 포드가 예상대로 시작되지 않습니다. 이 문제를 해결하려면 cert-manager 1.10 출시 노트에 설명된 대로 보안 구성 제약조건을 수정합니다.

270371160

Hybrid 1.9.0 이상 해결됨 Apigee 인그레스 게이트웨이는 TLS1.2 이상 프로토콜/암호화만 지원합니다.

Apigee 인그레스 게이트웨이는 TLS1.2 이상만 지원하며 이전 버전의 TLS는 지원하지 않습니다.

269139342

Hybrid 1.7.0 이상 미해결 apigeectl getOrgoverrides.yamlHTTP_PROXY 설정을 따르지 않음

Apigee 조직 유효성 검사가 overrides.yaml에 설정된 HTTP 전달 프록시 규칙을 따르지 않습니다. 이 유효성 검사를 건너뛰려면 validateOrg: false로 설정하세요.

266452840

Apigee
Hybrid 1.7.0 이상
Hybrid 1.8.0 이상
Hybrid 1.9.0 이상
미해결 Apigee X 및 Apigee Hybrid에서 Anthos Service Mesh 1.15.3과 작동하지 않는 웹 소켓

특정 상황에서는 Anthos Service Mesh 1.15.3-asm.6을 사용할 때 Apigee X 및 Apigee Hybrid에 웹 소켓이 작동하지 않습니다.

242213234

Apigee 미해결 '연결을 사용할 수 없음' 오류와 함께 API 제품이 로드되지 않음

API 제품을 로드하려고 하면 '제품이 로드되지 않았습니다. 오류: Apigee Connect 에이전트에서 사용할 수 있는 연결이 없습니다.'라는 오류가 반환될 수 있습니다.

이 문제는 Google Cloud 프로젝트에서 VPC 서비스 제어를 사용 설정하고 iamcredentials.googleapis.com을 서비스 경계에서 제한된 서비스 중 하나로 추가한 후 발생합니다.

해결 방법: 다음과 같은 이그레스 규칙을 수동으로 만듭니다.

-egressTo:
    operations:
    -serviceName: "iamcredentials.googleapis.com"
        methodSelectors:
        -method:
    resources:
    -projects/608305225983
  egressFrom:
    identityType: ANY_IDENTITY

247540503

Hybrid 1.7.0 이상
Hybrid 1.8.0 이상
미해결 암호화 키 조회와의 경합 상태로 인해 KVM 조회가 실패할 수 있음

처리량이 매우 높은 특정 상황에서는 암호화 키 조회와의 경합 조건으로 인해 KVM 조회가 실패할 수 있습니다.

258699204

Hybrid 1.8.0 이상 미해결 측정항목 포드에 대한 기본 메모리 요청 및 제한이 1.8.x에서 의도치 않게 변경됨

apigee-telemetry-app 또는 apigee-telemetry-proxy 포드가 실행되지 않는 문제가 발생한 경우 구성 속성 참조: 측정항목의 다음 기본값과 일치하도록 metrics 리소스 요청 및 리소스 제한을 변경하세요.

구성 속성 기본값
metrics.aggregator.resources.requests.memory: 512Mi
metrics.aggregator.resources.limits.memory: 3Gi
metrics.app.resources.requests.memory: 512Mi
metrics.app.resources.limits.memory: 1Gi
metrics.appStackdriverExporter.resources.requests.memory: 512Mi
metrics.appStackdriverExporter.resources.limits.memory: 1Gi
metrics.proxy.resources.requests.memory: 512Mi
metrics.proxy.resources.limits.memory: 1Gi
metrics.proxyStackdriverExporter.resources.requests.memory: 512Mi
metrics.proxyStackdriverExporter.resources.limits.memory: 1Gi

‑‑telemetry 플래그를 사용하여 apigeectl apply에 변경사항을 적용합니다.

apigeectl apply --telemetry -f overrides.yaml

260324159

Apigee 1-9-0-apigee-16 미해결 API 프록시 및 공유 흐름 배포에 최대 30분 소요

API 프록시 및 공유 흐름은 동기화 담당자의 '소켓 닫힘' 오류로 인해 특정 상황에서 런타임 영역에 배포하는 데 20~30분 정도 걸릴 수 있습니다.

254505866

API 허브 해결됨 새 리전으로 인해 프로비저닝 실패

다음 리전 이외의 리전을 선택하면 UI를 사용하여 API 허브를 프로비저닝할 수 없습니다.

  • asia-east1
  • asia-southeast1
  • europe-west1
  • europe-west4
  • us-central1
  • us-east1
  • us-west1
  • us-west4

251897633

문서 미해결 Apigee Hybrid 버전 선택기

Apigee Hybrid 버전 선택기는 텍스트를 선택하거나 직접 클릭한 경우에만 작동합니다.

250875730

전체 미해결 감사 로그에 '전제조건을 확인하지 못했습니다.'라는 메시지가 표시됩니다.

1분 간격으로 표시될 것이며 청구 비용에는 영향을 미치지 않습니다.

260772383

Hybrid 1.8.0 이상 미해결 AKS 플랫폼의 소켓 바인딩 오류

AKS에 하이브리드를 설치할 때 다음 오류가 표시될 수 있습니다.

envoy config listener '0.0.0.0_443' failed to bind or apply socket options: cannot bind '0.0.0.0:443': Permission denied

해결 방법: 오버라이드 파일에 다음 svcAnnotations 스탠자를 추가합니다.

ingressGateways:
- name: INGRESS_NAME
...
svcAnnotations:
service.beta.kubernetes.io/azure-load-balancer-internal: "true"

하이브리드 런타임 구성을 참조하세요. 또한 AKS에 내부 부하 분산기 사용을 참조하세요.

241786534

Hybrid 1.8.0 이상 미해결 MART에서 FluentD에 연결할 수 없는 경우도 있습니다.

조직 범위 UDCA를 사용할 때 MART에서 FluentD에 연결할 수 없는 경우가 있습니다. 조직 범위 UDCA는 Apigee Hybrid 버전 1.8의 기본값입니다. 구성 속성 참조는 orgScopedUDCA를 참조하세요.

해당 사항 없음 Hybrid 1.6.0 이상 미해결 apigee-logger가 CentOS 또는 RHEL이 포함된 Anthos 베어메탈에서 작동하지 않습니다.

Apigee Hybrid 버전 1.6.6에서 apigee-loggerfluend에서 fluent-bit로 마이그레이션한 후 로거가 CentOS 또는 RHEL이 포함된 Anthos BareMetal에서 작동하지 않습니다.

231758700
231976420

Hybrid 1.5.0 이상 미해결 Apigee Hybrid Dockerhub 고객은 Docker Content Trust가 사용 설정된 이미지를 가져올 수 없습니다.

사용자가 Docker Hub에서 Apigee Hybrid의 이미지를 가져올 때 다음 오류가 발생합니다. ERRO[0001] Metadata for targets expired 이는 다음 하이브리드 구성요소에 적용됩니다.

  • google/apigee-authn-authz
  • google/apigee-mart-server
  • google/apigee-runtime
  • google/apigee-synchronizer

해결 방법

이 오류가 발생하면 다음 두 가지 해결 방법 중 하나를 사용할 수 있습니다.

  • gcr.io/apigee-release를 사용하여 하이브리드 이미지를 가져오기
  • DOCKER_CONTENT_TRUST 환경 변수를 0으로 설정하여 Docker 콘텐츠 신뢰 사용 중지
207762842 Hybrid 1.5.0 이상 미해결 apigee-logger를 통해 로그가 Cloud Logging에 제공되지 않습니다.

활성 프로브를 포함하여 현재 apigee-logger 구성이 Kubernetes 런타임과 호환되지 않아서 로그가 Cloud Logging에 예상한 대로 전달되지 않습니다. 이 문제는 또한 정기적인 apigee-logger 포드 충돌을 일으킬 수 있습니다. 이 문제는 AKS, Anthos 베어메탈, 기타 플랫폼의 Apigee Hybrid 설치에 영향을 줍니다. 일부 경우에는 이 문제로 인해 과도한 로그 볼륨이 발생할 수 있습니다.

203827738 보관 파일 배포 미해결 작업 없이 구성 가능한 API 프록시가 실패합니다.

작업을 포함하지 않거나 HTTP 일치 항목이 없는 작업을 포함하는 프록시는 요청 경로에 기본 경로 외에 정확히 1개의 세그먼트가 포함되지 않은 경우 404 오류 코드를 반환합니다. 예를 들어 /basepath에 대한 요청은 실패하지만 /basepath/user에 대한 요청은 성공할 수 있습니다. 실패를 방지하려면 구성 가능한 API 프록시에 http_match가 하나 이상 있는 Operations 섹션을 추가합니다.

201429104 Apigee 미해결 프록시 기본 경로에서 와일드 카드의 요청 경로가 잘못되었습니다.

구성 가능한 API 프록시의 프록시 기본 경로에서 와일드 카드(*)를 사용하면 잘못된 요청 경로가 백엔드 대상으로 전달됩니다.

잘못된 요청 경로 전달을 방지하기 위해서는 문제가 해결될 때까지 구성 가능한 API 프록시 기준 경로에서 *를 사용하지 마세요.

191291501, 191000617 Apigee 미해결 UI에서 개발자 항목의 이메일 주소가 변경되지 않습니다.
191002224 Hybrid 1.5.0 이상 미해결 PUT /organizations/{org_name}/developers/{developer_email} API를 사용하는 동안 이메일 주소 변경이 실패합니다.
184555974 Hybrid 1.5.0 이상 미해결 apigee-logger Fluentd는 OpenShift 클러스터의 로그를 파싱할 수 없습니다.
해당 사항 없음 보관 파일 배포 미해결 UI에서 Apigee 보관 파일 배포 관리 및 디버깅이 지원되지 않습니다.

Apigee UI에서는 API 프록시 배포에 설명된 대로 배포 상태를 보거나, 확인하거나, 보관 파일 배포를 관리할 수 없거나, 디버그 사용에 설명된 대로 디버그 UI를 사용할 수 있습니다. 이 문제를 해결하려면 gcloud 또는 API를 사용하여 환경의 모든 보관 파일 배포 나열디버그 API를 사용하면 됩니다.

해당 사항 없음 보관 파일 배포 미해결 보관 파일 배포 롤백이 지원되지 않습니다.

보관 파일 배포 롤백이 현재 지원되지 않습니다. 보관 파일 배포 버전을 삭제하려면 보관 파일의 이전 버전을 다시 배포하거나 환경을 삭제해야 합니다.

해당 사항 없음 VS Code의 Apigee 미해결 정책의 Google 인증은 Visual Studio Code(VS Code)의 Apigee에서 지원되지 않습니다.

Google 인증 사용의 설명과 같이, ServiceCallout 및 ExternalCallout 정책의 Google 인증은 VS Code의 Apigee에서 지원되지 않습니다.

146222881 Hybrid 1.3.0 이상 미해결 잘못된 HTTP 헤더 오류

잘못된 HTTP 헤더 오류: Istio 인그레스가 모든 수신 대상 응답을 HTTP2 프로토콜로 전환합니다. Hybrid 메시지 프로세서는 HTTP1만 지원하므로 API 프록시가 호출되면 다음 오류가 표시될 수 있습니다.

http2 error: Invalid HTTP header field was received: frame type: 1, stream: 1,

name: [:authority], value: [domain_name]

이 오류가 표시되면 다음 작업 중 하나를 수행하여 문제를 해결할 수 있습니다.

  • 응답에서 호스트 헤더를 생략하도록 대상 서비스를 수정합니다.
  • 필요한 경우 API 프록시에서 AssignMessage 정책을 사용하여 호스트 헤더를 삭제합니다.

해당 사항 없음 통합 포털 미해결 SmartDocs
  • 포털에서 SmartDocs를 사용하여 API를 게시하는 경우 Apigee는 OpenAPI 사양 3.0을 지원하지만 일부 기능은 아직 지원되지 않습니다. 예를 들어 스키마를 결합하고 확장하는 allOf 속성입니다.

    OpenAPI 사양에서 지원되지 않는 기능을 참조하는 경우 경우에 따라 도구에서 기능을 무시하지만 API 참조 문서를 계속 렌더링합니다. 다른 경우에는 지원되지 않는 기능으로 인해 API 참조 문서가 성공적으로 렌더링되지 못하는 오류가 발생합니다. 두 경우 모두 지원되지 않는 기능이 향후 출시 버전에서 지원될 때까지 사용되지 않도록 OpenAPI 사양을 수정해야 합니다.

  • 포털에서 이 API 사용해 보기를 사용하는 경우 OpenAPI 사양에서 consumes에 설정된 값에 관계없이 Accept 헤더가 application/json으로 설정됩니다.
해당 사항 없음 통합 포털 미해결 포털 관리자

  • 현재 여러 사용자의 동시 포털 업데이트(예: 페이지, 테마, CSS, 스크립트 수정)는 지원되지 않습니다.
  • 포털에서 API 참조 문서 페이지를 삭제하면 다시 생성할 수 없습니다. API 제품을 삭제 및 다시 추가하고 API 참조 문서를 다시 생성해야 합니다.
  • 포털 테마를 맞춤설정할 때 변경사항이 완전히 적용되는 데 최대 5분이 걸릴 수 있습니다.
해당 사항 없음 통합 포털 미해결 포털 기능

향후 출시 버전에서는 통합 포털에 검색이 통합될 예정입니다.

해당 사항 없음 통합 포털 미해결 SAML ID 공급업체

SAML ID 공급업체를 사용한 단일 로그아웃 (SLO)은 커스텀 도메인에 대해 지원되지 않습니다. SAML ID 공급업체를 사용하여 커스텀 도메인을 사용 설정하려면 SAML 설정을 구성할 때 로그아웃 URL 필드를 비워둡니다.

191815997 Hybrid 1.6.0 이상 미해결 하이브리드 고객이 API 프록시에 전달 프록시를 구성하는 경우 Google 토큰은 *.googleapis.com에 직접 액세스할 수 없는 한 작동하지 않습니다.
해당 사항 없음 Apigee Apigee 1-12-0-apigee-2 및 Hybrid 1.12.0에서 해결됨 API 모니터링 및 Cloud Monitoring에 이상 급증 표시

  • API 프록시 요청 및 응답 수(프록시 및 대상)에 이상 급증 표시

    다음은 이러한 급증을 보여주는 예시입니다.

    (큰 이미지 보기)

  • 버그로 인해 시스템에서 짧은 기간 동안 개수가 잘못 등록되고, 개수가 수정됩니다. 이 문제는 API 트래픽 감소가 있을 때 발생합니다(API 게이트웨이의 축소 발생).
  • 요청 실제 급증과 이 문제를 구분하기 위해서는 API 분석 페이지(특히 프록시 성능대상 성능 페이지)를 참조하세요.

영향을 받는 측정항목:

  • apigee.googleapis.com/proxyv2/request_count
  • apigee.googleapis.com/proxyv2/response_count
  • apigee.googleapis.com/targetv2/request_count
  • apigee.googleapis.com/targetv2/response_count

새 측정항목

새 측정항목을 사용하면 이 문제를 방지할 수 있습니다.

측정항목 설명
apigee.googleapis.com/proxy/request_count 마지막 샘플이 기록된 이후 Apigee 프록시에 대한 요청 수입니다.
apigee.googleapis.com/proxy/response_count Apigee API 프록시에서 전송한 응답 수입니다.
apigee.googleapis.com/proxy/latencies Apigee 프록시에서 요청을 수신한 시간부터 Apigee 프록시에서 클라이언트로 응답을 전송한 시간까지 계산되는 지연 시간의 분포입니다.
apigee.googleapis.com/target/request_count 마지막 샘플이 기록된 이후 Apigee 대상으로 전송된 요청 수입니다.
apigee.googleapis.com/target/response_count 마지막 샘플이 기록된 이후 Apigee 대상에서 수신된 응답 수입니다.
apigee.googleapis.com/target/latencies 요청이 Apigee 대상으로 전송된 시간부터 Apigee 프록시에서 응답을 수신한 시간까지 계산되는 지연 시간의 분포입니다. 시간에는 Apigee API 프록시 오버헤드가 포함되지 않습니다.

Apigee Hybrid의 경우 측정항목 수집 개요측정항목 보기를 참조하세요.

203778087 Hybrid 1.5.3 이상 미해결 apigee-stackdriver-logging-agent는 현재 루트로 실행됩니다.

해결 방법: Hybrid에서 Logging 에이전트를 사용 중지합니다.

205629443 Apigee 미해결 ServiceCallout이 파이어 앤 포겟(fire and forget)이 되면(<Response> 태그 없음) 그 이후에는 다른 정책이 발생하면 경합 상태가 발생할 수 있습니다.

해결 방법: 파이어 앤 포겟(fire and forget) 방식의 동작을 유지하려면 다음 안내를 따르세요.

  1. ServiceCallout에 <Response>calloutResponse</Response>를 추가합니다.
  2. continueOnErrortrue로 설정합니다.
207719377 Apigee Apigee 1-11-0-apigee-1에서 해결됨 번들에 두 개 이상의 SpikeArrest 정책이 있는 경우 502 오류가 발생합니다.

해결 방법: 문제를 방지하려면 프록시에 SpikeArrest 정책을 두 개 이상 사용하지 마세요.

209097822 Hybrid 1.5.0 이상
Apigee
미해결 급증 저지 속도의 동적 업데이트는 즉시 반영되지 않을 수 있음

특정 키의 경우 지속적인 트래픽이 있으면 키가 업데이트된 속도로 비율 제한되지 않을 수 있습니다. 특정 키에 대한 트래픽이 5분 동안 발생하지 않으면 비율이 반영됩니다.

해결 방법: 속도를 즉시 적용해야 하는 경우 새 참조 변수로 프록시를 재배포합니다. 또는 흐름 변수가 서로 다른 두 개의 조건부 급증 저지를 사용하여 속도를 조정합니다.

221305498 Apigee 미해결 API 모니터링에 '(설정되지 않음)' 오류 코드가 표시될 수 있습니다.

구성 가능한 API 프록시의 API 모니터링은 대상의 2xx가 아닌 응답에 대해 '(설정되지 않음)' 오류 코드를 표시할 수 있습니다.

246774745 Apigee 해결됨 io.timeout.millis 값은 여러 동적 대상과 함께 사용될 경우 적용되지 않습니다.

프록시가 같은 대상 호스트를 사용하여 흐름 두 개 이상에서 io.timeout.millis 값을 두 개 이상 설정하면 io.timeout.millis 값 하나만 적용됩니다.

245664917 Hybrid 1.8.x 미해결 Apigee Hybrid 업그레이드 오류 무시 가능

Apigee Hybrid 1.8.x로 업그레이드하는 동안 apigeectl init 실행 및 check-ready 성공 확인 후 포드를 보면 Cassandra 스키마 검증 작업이 오류 상태인 것을 확인할 수 있습니다. 이것은 무해한 상태이며, 업그레이드 절차의 다음 단계로 이동해도 안전합니다.

300660653 Apigee 미해결 동일한 인스턴스 및 환경 그룹에 연결된 여러 환경에 동일한 경로의 프록시를 배포할 때는 오류가 반환되어야 하나, 반환되지 않습니다.

동일한 인스턴스 및 환경 그룹에 연결된 여러 환경에 동일한 경로의 프록시를 배포할 수 없으며 기본 경로 충돌에 대한 경고 메시지가 반환되어야 합니다. 대신 오류가 표시되지 않고 배포가 성공한 것으로 표시됩니다.

해결 방법: 배포 중, 그리고 배포 후에 배포된 프록시와 기본 경로 충돌이 없는지 확인하고 필요에 따라 수정합니다.

301458133 Apigee 미해결 일부 프록시 배포 시도는 버전을 변경할 수 없다는 오류를 반환합니다.

이전에 배포된 프록시를 저장하려고 하면 버전을 변경할 수 없다는 오류와 함께 배포가 실패할 수 있습니다.

해결 방법: 저장 버튼 옆에 있는 드롭다운 화살표를 클릭하고 새 버전으로 저장을 선택합니다. 그런 후 배포를 다시 시도합니다.

301845257 Apigee 해결됨 환경 그룹에 800개가 넘는 프록시를 배포하려고 하면 오류와 함께 실패합니다. 기본 경로가 15자(영문 기준)를 초과하면 오류 반환 한도는 800 미만입니다.

해당 사항 없음 Apigee 1-9-0-apigee-23 미해결 Unsupported protocol 오류가 발생한 클라이언트에 필요한 TLS 버전 업그레이드

보안 향상을 위해 Apigee 서버에서 지원되는 기본 암호화 세트를 업데이트하면 일부 TLS 버전에 Unsupported protocol 오류가 발생할 수 있습니다. 이러한 오류가 발생하는 고객은 Envoy의 FIPS 빌드에서 지원되는 전체 암호화 목록을 검토해야 합니다.

315874988 Apigee 미해결 gRPC 프록시 요청을 사용하면 gRPC 트레일러가 응답에서 삭제됩니다.

gRPC 대상 서버를 호출할 때 반환되는 유일한 트레일러는 'grpc-status' 트레일러입니다. 다른 모든 트레일러는 응답에서 삭제됩니다.

341157011 Apigee 미해결 Cloud Code의 Gemini Code Assist로 생성된 사양 중 비ASCII UTF-8 문자도 포함된 사양은 API 허브에 업로드할 때 올바르게 파싱되지 않습니다.

따라서 API 허브가 작업, 정의, 기타 메타데이터를 올바르게 추출하지 않습니다.
338285095 Apigee 해결됨 AppGroup과 연결된 앱은 Cloud 콘솔의 Apigee UI에 있는 앱 목록에 표시되지 않습니다. 따라서 사용자는 콘솔에서 앱의 앱 세부정보 페이지에 액세스할 수 없습니다. 이 문제가 해결될 때까지 부분적인 앱 이름 또는 앱에 대한 API 키 검색을 사용하여 콘솔에서 검색을 사용하는 것은 지원되지 않습니다.

Apigee Hybrid 조직은 기본 UI를 사용하여 앱 세부정보를 확인하므로 이 문제의 영향을 받지 않습니다.

부분 해결 방법: API를 사용하여 모든 앱 목록을 사용할 수 있습니다. organizations.apps.list를 참조하세요.
355714868 수익 창출
Apigee Hybrid
미해결 하이브리드 조직의 반복, 설정, 잔액 충전 수수료 데이터가 캡처 또는 청구되지 않음

수익 창출이 가능한 하이브리드 조직에서 반복(RECURRING_FEE), 설정 수수료(SETUP_FEE), 잔액 충전 수수료(TOPUP_FEE) 데이터가 후불 청구를 위해 캡처 또는 청구되지 않습니다. 선불 결제의 경우 이러한 수수료에 대해 지갑에서 공제되지만 보고되지는 않습니다.