차량에 대한 통합 가시성 설정
로깅 및 모니터링은 IBM Cloud® Code Engine 에서 문제를 해결하는 데 도움이 되며 워크로드 성능에 대한 인사이트를 제공할 수 있습니다. 플릿에 대한 로깅 및 모니터링 설정은 프로젝트 수준에서 이루어지며 다른 Code Engine 기능과는 다릅니다.
로깅 및 모니터링은 선택 사항이며, 플릿을 생성한 후 언제든지 설정할 수 있습니다.
차량 함대에 대한 로깅 설정
플릿에 대한 로깅은 프로젝트 수준에서 설정됩니다. 프로젝트에 대해 이러한 설정 단계를 수행하면 해당 프로젝트의 모든 플릿에 대해 로깅을 사용할 수 있습니다.
1. 기존 Cloud Logs 서비스 인스턴스가 있는지 확인합니다
플릿이 실행되는 Code Engine 프로젝트의 지역을 대상으로 하는 Cloud Logs 서비스 인스턴스가 있어야 합니다. 기존 클라우드 로그 서비스 인스턴스를 확인하려면 UI의 로깅 라우팅 페이지로 이동하여 해당 지역을 대상으로 하는 인스턴스를 식별하세요. 지역에 타겟 로깅 인스턴스가 없는 경우 UI의 안내에 따라 인스턴스를 설정합니다.
2. 클라우드 로그 인스턴스에 대한 권한 설정
클라우드 로그 인스턴스에 대한 액세스 권한을 할당하고 필요한 권한을 설정하는 서비스 ID와 API 키가 있는지 확인하세요.
- 서비스 ID를 작성하십시오. 그런 다음 계정의 클라우드 로그 인스턴스를 대상으로 하는 액세스 정책을 서비스 ID에 할당합니다. 이 액세스 정책에 발신자 서비스 액세스 수준을 할당합니다.
- 서비스 ID에 대한 API 키를 생성합니다. 나중에 참조할 수 있도록 API 키를 안전한 위치에 저장하세요.
3. 클라우드 로그 인스턴스에 대한 비공개 인그레스 엔드포인트 가져오기
클라우드 로그 인스턴스에 대한 비공개 인그레스 엔드포인트를 가져옵니다.
- UI에서 로깅 인스턴스 페이지로 이동하여 관련 인스턴스를 클릭합니다.
- ‘엔드포인트’를 클릭합니다.
- 비공개 인그레스 엔드포인트를 찾습니다. 나중에 참조할 수 있도록 이 값을 안전한 위치에 저장하세요.
4. 로깅 인스턴스에 연결되는 가상 사설 엔드포인트 게이트웨이 만들기
로깅 인스턴스에 연결되는 가상 비공개 엔드포인트 게이트웨이를 만듭니다. 이 VPE 게이트웨이는 차량이 실행되는 VPC에서 생성해야 합니다.
- 콘솔에서 VPE 게이트웨이 페이지로 이동합니다.
- 작성을 클릭하십시오.
- 클라우드 로그 인스턴스가 있는 위치 및 지역을 선택합니다.
- 차량이 실행되는 VPC를 선택합니다.
- 클라우드 로그 인스턴스에 서비스를 연결합니다.
- 서비스 연결 요청 섹션에서 IBM Cloud 서비스 옵션을 선택합니다.
- 클라우드 서비스 제공에서 클라우드 로그를 선택합니다.
- 클라우드 서비스 지역 아래에서 클라우드 로그 인스턴스가 있는 지역을 선택합니다.
- 표에서 관련 클라우드 로그 인스턴스를 선택하여 VPE에 연결합니다.
- 작성을 클릭하십시오.
5. VPE 게이트웨이에서 예약된 IP 주소 만들기
VPE의 각 영역에 대해 하나의 서브넷에 예약된 IP 주소를 추가합니다.
- 콘솔에서 VPE 게이트웨이 페이지로 이동합니다.
- 이전 단계에서 만든 VPE를 클릭합니다.
- '첨부된 리소스 관리'를 클릭하세요.
- ‘예약’ 또는 ‘IP 바인딩’을 클릭하세요.
- 안내에 따라 VPE 영역 중 하나에서 서브넷의 IP 주소를 예약합니다.
- 각 VPE 영역의 서브넷 하나에 대해 이 과정을 반복합니다.
6. 함대 기본 비밀에 로깅 값을 추가합니다
차량 기본 비밀에 필요한 로깅 값을 추가합니다.
- 콘솔에서 Code Engine 프로젝트 페이지로 이동하여 플릿이 실행되는 프로젝트를 선택합니다.
- 'Secrets'와 'configmaps'를 클릭하세요.
codeengine-fleet-defaults비밀을 클릭합니다.- 이전에 만들지 않은 경우: 만들기를 클릭합니다.
- 일반 비밀번호를 선택한 후 다음을 클릭합니다.
- 비밀의 이름
codeengine-fleet-defaults. 이 정확한 이름과 서식을 사용해야 합니다.
- 아래 표에 나열된 키-값 쌍을 추가합니다.
logging_sender_api_key및logging_ingress_endpoint은 이전 단계에서 저장한 것입니다.
| 키 | 값 |
|---|---|
logging_ingress_endpoint |
클라우드 로그 인스턴스의 비공개 인그레스 엔드포인트입니다. 이 값은 이전 단계에서 저장됩니다. |
logging_sender_api_key |
클라우드 로그 인스턴스를 대상으로 하는 서비스 ID의 API 키입니다. 이 값은 이전 단계에서 저장됩니다. |
logging_ingress_port |
클라우드 로그 인스턴스에 연결하는 데 사용되는 포트입니다. 비공개 VPE의 경우 443 를 지정합니다. |
logging_level_worker |
작업자 로그에 포함할 세부 정보의 수준입니다. 허용되는 레벨은 다음과 같습니다: DEBUG, INFO, WARN, ERROR 입니다. 기본 수준: WARN. |
logging_level_agent |
플릿 상담원 로그에 포함할 세부 정보 수준입니다. 허용되는 레벨은 다음과 같습니다: DEBUG, INFO, WARN, ERROR 입니다. 기본 수준: WARN. |
7. 차량 로그 보기
이제 Code Engine 프로젝트에서 플릿에 대한 로깅이 설정되었으므로 플릿 로그를 볼 수 있습니다. 단계는 차량에 대한 로그 및 모니터링 데이터 보기를 참조하세요.
차량 함대 모니터링 설정
차량에 대한 모니터링은 프로젝트 수준에서 설정됩니다. 프로젝트에 대해 이러한 설정 단계를 수행하면 해당 프로젝트의 모든 플릿에 대해 모니터링을 사용할 수 있습니다.
1. 기존 Clouds 모니터링 인스턴스가 있는지 확인하세요
차량이 속한 Code Engine 프로젝트의 동일한 지역에 Cloud Monitoring 인스턴스가 있어야 합니다. 기존 Cloud Monitoring 서비스 인스턴스를 확인하려면 UI의 모니터링 인스턴스 페이지로 이동하여 해당 지역의 인스턴스를 식별합니다. 적합한 인스턴스가 없는 경우 UI의 지시에 따라 인스턴스를 생성하세요.
2. 모니터링 에이전트 키 받기
모니터링 인스턴스에 대한 상담원 키를 찾습니다.
- UI에서 모니터링 인스턴스 페이지로 이동하여 관련 인스턴스를 클릭합니다. 인스턴스 세부정보 페이지에서 작업 > 키 관리를 클릭한 다음 대시보드에서 모든 키를 볼 수 있는 옵션을 클릭합니다.
ab1c2345-****-678d9efgh012과 유사한 형식의 상담원 키를 클릭합니다. 그런 다음 전체 상담원 키를 복사하는 옵션을 클릭합니다.- 상담원 키를 나중에 액세스할 수 있는 안전한 위치에 저장하세요.
3. 모니터링 인스턴스에 연결되는 가상 사설 엔드포인트 게이트웨이 만들기
모니터링 인스턴스에 연결되는 가상 사설 엔드포인트 게이트웨이를 만듭니다. 이 VPE 게이트웨이는 차량이 실행되는 VPC에서 생성해야 합니다.
- 콘솔에서 VPE 게이트웨이 페이지로 이동합니다.
- 작성을 클릭하십시오.
- Cloud Monitoring 인스턴스가 위치한 위치와 지역을 선택하십시오.
- 차량이 실행되는 VPC를 선택합니다.
- 이 서비스를 Cloud Monitoring 인스턴스에 연결하세요.
- 서비스 연결 요청 섹션에서 IBM Cloud 서비스 옵션을 선택합니다.
- **클라우드 서비스 오퍼링에서 **Cloud Monitoring.
- 클라우드 서비스 지역 아래에서 Cloud Monitoring 인스턴스가 있는 지역을 선택합니다.
- 표에서 관련 Cloud Monitoring 인스턴스를 선택하여 VPE에 연결합니다.
- 작성을 클릭하십시오.
4. VPE 게이트웨이에서 예약된 IP 주소 만들기
VPE의 각 영역에 대해 하나의 서브넷에 예약된 IP 주소를 추가합니다.
- 콘솔에서 VPE 게이트웨이 페이지로 이동합니다.
- 이전 단계에서 만든 VPE를 클릭합니다.
- '첨부된 리소스 관리'를 클릭하세요.
- ‘예약’ 또는 ‘IP 바인딩’을 클릭하세요.
- 안내에 따라 VPE 영역 중 하나에서 서브넷의 IP 주소를 예약합니다.
- 각 VPE 영역의 서브넷 하나에 대해 이 과정을 반복합니다.
5. 차량 기본 비밀에 모니터링 값 추가
- 콘솔에서 Code Engine 프로젝트 페이지로 이동하여 플릿이 실행되는 프로젝트를 선택합니다.
- 'Secrets'와 'configmaps'를 클릭하세요.
codeengine-fleet-defaults비밀을 클릭합니다.- 이전에 만들지 않은 경우: 만들기를 클릭합니다.
- 일반 비밀번호를 선택한 후 다음을 클릭합니다.
- 비밀의 이름
codeengine-fleet-defaults. 이 정확한 이름과 서식을 사용해야 합니다.
- 아래 표에 나열된 키-값 쌍을 추가합니다.
monitoring_ingestion_key은 이전 단계에서 저장되었습니다.
| 키 | 값 |
|---|---|
monitoring_ingestion_region |
Cloud Monitoring 인스턴스가 존재하는 지역입니다. 예: au-syd. |
monitoring_ingestion_key |
모니터링 에이전트 키입니다. 이 값은 이전 단계에서 찾은 값입니다. |
6. 모니터링 대시보드에서 차량 데이터 보기
이제 Code Engine 프로젝트에서 플릿에 대한 모니터링이 설정되었으므로 플릿 모니터링 데이터를 볼 수 있습니다. 단계는 차량에 대한 로그 및 모니터링 데이터 보기를 참조하세요.