Apigee API Hub for Private Cloud 커넥터의 로컬 상태 엔드포인트를 쿼리하여 언제든지 메타데이터 및 런타임 데이터 업로드 상태를 확인할 수 있습니다.
업로드 상태 확인
Apigee API Hub for Private Cloud 커넥터를 실행하는 가상 머신에서 다음 curl 명령어를 사용합니다.
curl localhost:8080/v1/uapim/status
{
"apiSyncStatus": [
{
"organization": "foo",
"phase": "Preparing",
"components": [
"proxy": {
"lastUpdated": "2025-04-16T00:56:45Z",
"progress": {
"totalItems": 100,
"pendingItems": 90,
"completedItems": 6,
"failedItems": 4
}
},
"environment": { //environment upload status
"lastUpdated": "2025-04-16T00:56:45Z",
"progress": {
"totalItems": 5,
"pendingItems": 1,
"completedItems": 3,
"failedItems": 1
}
}]
},
{
"organization": "bar",
"phase": "Processing",
"components": [
"proxy": {
"lastUpdated": "2025-04-16T00:56:45Z",
"progress": {
"totalItems": 110,
"pendingItems": 16,
"completedItems": 3,
"failedItems": 1
}
},
"environment": {
"lastUpdated": "2025-04-16T00:56:45Z",
"progress": {
"totalItems": 5,
"pendingItems": 3,
"completedItems": 1,
"failedItems": 1
}
}]
},
{
"organization": "test",
"phase": "Queued",
"lastUpdated": "2025-04-16T00:56:45Z"
}
],
"analyticsSyncStatus": [
{
"organization": "test",
"environment": "dev",
"failedItems": 2,
"lastUpdated": "2025-04-16T00:56:45Z"
},
{
"organization": "test",
"environment": "prod",
"failedItems": 4,
"lastUpdated": "2025-04-16T00:56:45Z"
}
]
}
출력은 다음 사항에 대한 통계를 제공합니다.
- API 메타데이터: 조직, 환경, 현재 단계('준비 중', '처리 중', '대기열에 추가됨' 등), 총/완료/대기 중 업로드, 오류 수, 마지막 업데이트 시간을 비롯한 API 메타데이터 업로드 상태입니다.
- 런타임 메타데이터: 런타임 데이터 업로드 상태로, 조직, 환경, 오류 수, 마지막 업데이트 시간을 표시합니다.
일반적인 문제 및 문제 해결 단계
문제가 발생하면 커넥터의 로그와 상태 엔드포인트를 참고하세요. Apigee 허브 커넥터의 기본 로그 파일은 /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log에 있습니다.
- 프라이빗 클라우드용 Apigee API 허브 커넥터가 시작되지 않음:
- 로그 확인:
/opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log에서 구성과 관련된 오류 메시지를 검사합니다. - 설정 확인:
uapim-connector.properties및 환경 변수에서 구성된 모든 설정을 다시 한번 확인합니다. - Pub/sub 액세스: 로그에서
opdk-connector이 제공된 Pub/Sub 주제에 액세스할 수 있는지 확인합니다. - 관리 서버 액세스:
opdk-connector가 지정된 URL과 사용자 인증 정보로 Apigee 관리 서버를 성공적으로 호출할 수 있는지 로그를 확인합니다. - 시작 시간: Apigee 환경에 수천 개의 배포가 있는 경우 Apigee 허브 커넥터가 시작하는 데 약 20~30분이 걸릴 수 있습니다.
- 로그 확인:
- API 메타데이터가 API 허브에 표시되지 않음:
- 커넥터 로그:
opdk-connector로그를 검토하여 API 메타데이터 Pub/Sub 주제에 액세스하고 관리 서버를 호출할 수 있는지 확인합니다. - 업로드 상태:
curl localhost:8080/v1/uapim/status출력을 확인합니다.APIMetadata섹션을 찾습니다.- lastUpdated가 최근인가요?
- errorCount가 지속적으로 증가하나요?
- 어떤 단계에 있나요?
- 예외/오류: 로그에서 메타데이터 처리와 관련된 예외 또는 오류가 발생했는지 검색합니다.
- 커넥터 로그:
- 런타임 데이터가 API 허브에 표시되지 않음:
- 커넥터 로그: opdk-connector가 런타임 Pub/Sub 주제에 액세스하고 관리 서버를 호출할 수 있는지 확인합니다.
- 업로드 상태:
curl localhost:8080/v1/uapim/status명령어를 사용합니다.RuntimeData섹션에 집중하세요.- lastUpdated가 최근인가요?
- errorCount가 지속적으로 증가하나요?
- 예외/오류: 런타임 데이터 처리와 관련된 로그에서 예외 또는 오류를 찾습니다.
- 메시지 프로세서 구성: 이중 쓰기를 위해 모든 MP에서
message-processor-communication.properties가 올바르게 구성되어 있고 MP가 다시 시작되었는지 확인합니다. - NFS 마운트: NFS 마운트가 올바르게 구성되어 있고 MP와 UAPIM 커넥터 모두에서 액세스할 수 있는지 확인합니다.
- 프록시가 배포되었지만 API 허브의 정보가 정확하지 않음:
- 대기 시간: 데이터가 전파될 때까지 몇 분 정도 기다립니다.
- 로그: 업로드된 프록시에 관한 정보를
opdk-connector로그에서 확인합니다. 이를 통해 커넥터가 배포 이벤트를 처리하는지 확인할 수 있습니다.