플랫폼 로깅을 사용하기 위한 전제조건

IBM Analytics Engine 플랫폼 로그를 보려면 IBM Cloud에서 관찰 가능성 대시보드를 사용하여 플랫폼 로깅을 구성해야 합니다. 관찰 가능성 대시보드를 통해 로깅을 사용으로 설정하기 위해 수행해야 하는 단계는 관찰 가능성 대시보드를 통해 플랫폼 로그 구성 을 참조하십시오.

로깅 API

관찰 가능성 대시보드를 통해 플랫폼 로깅을 사용으로 설정한 후 다음 섹션의 단계를 진행하여 API 엔드포인트를 사용하여 로깅을 사용으로 설정하고, 로깅을 사용 안함으로 설정하고, 로깅 구성을 보는 방법을 학습하십시오.

로깅 API 호출에는 서비스 인스턴스의 GUID가 필요합니다. GUID를 기록하지 않은 경우 서버리스 인스턴스의 GUID 검색을 참조하십시오.

이제 두 개의 로깅 API 엔드포인트가 노출됩니다.

• log_forwarding_config
• logging 이 API 엔드포인트는 더 이상 사용되지 않으며 곧 중단됩니다. 이 엔드포인트를 사용할 수 있지만 log_forwarding_config 엔드포인트 사용을 시작해야 합니다.

IBM Analytics Engine에서 로그 전달 사용

IBM Analytics Engine 플랫폼 로그를 IBM Cloud 로그에 전달하려면 기존 Analytics Engine 인스턴스에 대해 다음 API를 호출하세요.

로그 전달을 사용으로 설정하는 데 사용할 수 있는 두 가지 방법이 있습니다.

• 기본값: 이 경우 로그 전달을 사용으로 설정하기 위한 요청만 넣으면 기본 로그 소스 (spark-driver) 와 관련된 로그가 전달되기 시작합니다. 다음 중 한 방법을 사용할 수 있습니다.

  • log_forwarding_config API 엔드포인트를 사용하여 다음을 수행하십시오.

    curl -X PUT https://api.us-south.ae.cloud.ibm.com/v3/analytics_engines/<instance_guid>/log_forwarding_config -H "Authorization: Bearer $TOKEN" -H "content-type: application/json" -d '{"enabled":true}'
    

  • logging API 엔드포인트를 사용하여 (더 이상 사용되지 않음):

    curl -X PUT https://api.us-south.ae.cloud.ibm.com/v3/analytics_engines/<instance_guid>/logging -H "Authorization: Bearer $TOKEN" -H "content-type: application/json" -d '{"enable":true}
    

• 사용자 정의됨: 이 옵션을 사용하면 로그 전달 구성을 더 많이 제어할 수 있습니다. 예를 들어, 전달하려는 로그의 소스를 지정할 수 있습니다. 또한 일부 태그를 로그와 연결하도록 선택할 수 있으며, 나중에 IBM Cloud Logs에서 검색 키워드로 사용하여 해당 로그의 검색 범위를 좁힐 수 있습니다. 다음 중 한 방법을 사용할 수 있습니다.

  • log_forwarding_config API 엔드포인트를 사용하여 다음을 수행하십시오.

    curl -X PUT https://api.us-south.ae.cloud.ibm.com/v3/analytics_engines/<instance_guid>/log_forwarding_config -H "Authorization: Bearer $TOKEN" -H "content-type: application/json" -d ' {"enabled":true,"sources": ["spark-driver", "spark-executor"],"tags": ["<tag_1>", "<tag_2>",...]} '
    

  • logging API 엔드포인트를 사용하여 (더 이상 사용되지 않음):

    curl -X PUT https://api.us-south.ae.cloud.ibm.com/v3/analytics_engines/<instance_guid>/logging -H "Authorization: Bearer $TOKEN" -H "content-type: application/json" -d ' {"enable":true,"components": ["spark-driver", "spark-executor"],"tags": ["<tag_1>", "<tag_2>",...]} '
    

IBM Analytics Engine에서 플랫폼 로깅 사용 안함

다음 방법 중 하나를 사용하여 IBM Analytics Engine 플랫폼 로그를 IBM Cloud 로그에 전달하지 않도록 설정합니다.

• log_forwarding_config API 엔드포인트를 사용하여 다음을 수행하십시오.

  curl -X PATCH https://api.us-south.ae.cloud.ibm.com/v3/analytics_engines/<instance_guid>/log_forwarding_config -H "Authorization: Bearer $TOKEN" -H "content-type: application/json" -d '{"enabled":false}'
  

• logging API 엔드포인트를 사용하여 (더 이상 사용되지 않음):

  curl -X PATCH https://api.us-south.ae.cloud.ibm.com/v3/analytics_engines/<instance_guid>/logging -H "Authorization: Bearer $TOKEN" -H "content-type: application/json" -d '{"enable":false}'
  

IBM Analytics Engine 인스턴스의 로그 전달 구성 보기

다음 방법 중 하나로 IBM Analytics Engine 인스턴스의 현재 로깅 구성을 보십시오.

• log_forwarding_config API 엔드포인트를 사용하여 다음을 수행하십시오.

  curl -X GET https://api.us-south.ae.cloud.ibm.com/v3/analytics_engines/<instance_guid>/log_forwarding_config -H "Authorization: Bearer $TOKEN"
  

• logging API 엔드포인트를 사용하여 (더 이상 사용되지 않음):

  curl -X GET https://api.us-south.ae.cloud.ibm.com/v3/analytics_engines/<instance_guid>/logging -H "Authorization: Bearer $TOKEN"
  

IBM Cloud 로그 대시보드의 IBM Analytics Engine 로그 검색 예시

다음과 같이 IBM Analytics Engine 과 관련된 플랫폼 로그의 검색 범위를 좁힐 수 있습니다.

1. IBM Cloud 로그 대시보드에서 ' Sources '을 클릭하고 ' ibmanalyticsengine '를 선택하면 IBM Analytics Engine 로그를 가져올 수 있습니다.
2. 검색 범위를 더 좁히기 위해 검색 창에서 Spark 애플리케이션과 관련된 키워드를 입력하고 검색할 수 있습니다.