Apigee API Hub for Private Cloud 커넥터의 로컬 상태 엔드포인트를 쿼리하여 언제든지 메타데이터 및 런타임 데이터 업로드 상태를 확인할 수 있습니다.
업로드 상태 확인
Apigee API Hub for Private Cloud 커넥터를 실행하는 가상 머신에서 다음 curl 명령어를 사용합니다.
curl localhost:8080/v1/uapim/status
{
"APIMetadata": [
{
"organization": "test",
"environment": "dev",
"stage": "BULK_TRANSFER",
"totalDeployments": 100,
"completed": 10,
"lastUpdated": "04-16-2025 00:56:45",
"errors": 0
},
{
"organization": "test",
"environment": "prod",
"stage": "STREAMING",
"pendingUploads": 10,
"errors": 1,
"lastUpdated": "04-16-2025 00:56:45"
},
{
"organization": "test1",
"environment": "staging",
"stage": "Yet to Start",
"lastUpdated": "04-16-2025 00:56:45"
}
],
"RuntimeData": [
{
"organization": "test",
"environment": "dev",
"errorCount": 2,
"lastUpdated": "04-16-2025 00:56:45"
},
{
"organization": "test",
"environment": "prod",
"errorCount": 4,
"lastUpdated": "04-16-2025 00:56:45"
},
{
"organization": "test1",
"environment": "staging",
"errorCount": 0,
"lastUpdated": "04-16-2025 00:56:45"
}
]
}출력은 다음 사항에 대한 통계를 제공합니다.
- 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로그에서 확인합니다. 이를 통해 커넥터가 배포 이벤트를 처리하는지 확인할 수 있습니다.