IBM Cloud Logs IBM Cloud Event Notifications 과 연결하기 위한 아웃바운드 통합 구성

IBM Cloud Logs 인스턴스에서 알림이 트리거될 때 생성되는 이벤트를 보내려면 아웃바운드 연동 서비스를 구성하여 IBM Cloud Logs 인스턴스를 Event Notifications 에 연결해야 합니다.

전제조건

1단계. 서비스 간 권한 부여 정의

IBM Cloud 계정에서 서비스 간 권한 부여를 사용하여 IBM Cloud Logs 서비스가 Event Notifications 서비스로 이벤트를 전송하도록 권한을 부여합니다.

IBM Cloud Logs 인스턴스와 Event Notifications 인스턴스 간에 서비스 간 권한 부여를 구성해야 합니다. 자세한 내용은 IBM Cloud Event Notifications 서비스를 사용하기 위한 S2S 권한 부여 만들기를 참조하세요.

2단계. API를 사용하여 아웃바운드 연동 구성하기

API를 사용하여 아웃바운드 통합을 만들 수 있습니다. API 방법에 대한 자세한 내용은 아웃바운드 통합 만들기를 참조하세요.

서로 다른 계정에 있는 IBM Cloud Logs 인스턴스와 Event Notifications 인스턴스 간의 통합은 API를 통해서만 구성할 수 있습니다.

예를 들어 다음 cURL 명령을 사용하여 API를 통해 통합을 만들 수 있습니다:

curl -X POST "https://API-ENDPOINT/v1/outgoing_webhooks" \
 -H "Authorization: ${IAM_TOKEN}" \
 -H "Accept: application/json" \
 -H "Content-Type: application/json" \
 -d '{
  "type": "ibm_event_notifications",
  "name": "<NAME>",
  "ibm_event_notifications": {
   "event_notifications_instance_id": "<EventNotificationsInstanceID>",
   "region_id": "<Region-of-EventNotifications-Instance>",
   "endpoint_type": "default_or_public"
  }
 }'

여기서,

  • API-ENDPOINT: IBM Cloud Logs 인스턴스에 대한 API 엔드포인트를 설정합니다.

  • type: 통합 유형을 정의합니다. Ibm_event_notifications로 설정합니다.

  • name: 이 리소스 정의의 이름을 입력합니다.

  • IAM_TOKEN: IAM_TOKEN을 입력합니다. 다음 명령을 실행하여 IAM 토큰을 가져올 수 있습니다:

    export IAM_TOKEN=`ibmcloud iam oauth-tokens --output json | jq -r '.iam_token'`
    
  • event_notifications_instance_id: Event Notifications 인스턴스 ID로 설정합니다.

  • region_id: Event Notifications 인스턴스를 사용할 수 있는 지역으로 설정합니다.

  • endpoint_type: 통합이 공용 네트워크를 통과할지 비공개 네트워크를 통과할지 정의합니다. 유효한 값은 default_or_public 또는 private

2단계. UI에서 아웃바운드 통합 구성하기

아웃바운드 통합을 구성하려면 다음 단계를 완료하세요:

  1. 콘솔에서 탐색 메뉴 아이콘 탐색 메뉴 아이콘 > 리소스 목록 을 클릭합니다.
  2. IBM Cloud Logs의 인스턴스를 선택하십시오.
  3. IBM Cloud Logs 탐색에서 연동 서비스 아이콘 연동 서비스 아이콘 > 아웃바운드 연동 서비스를 클릭합니다.
  4. 아웃바운드 통합 섹션에서 Event Notifications 찾아 추가를 클릭합니다.
  5. 통합 페이지에서 새로 추가를 클릭합니다.
  6. 계정에 IBM Cloud Logs 과 Event Notifications 사이에 IAM 인증이 없는 경우 IAM 인증을 클릭하여 인증 인증을 구성해야 합니다. 프롬프트에 따라 서비스 간에 액세스 권한을 부여하십시오. 자세한 내용은 IBM Cloud Event Notifications 서비스를 사용하기 위한 S2S 권한 부여 만들기를 참조하세요.
  7. 통합의 이름을 입력하십시오.
  8. Event Notifications IBM Cloud Logs site.data.keyword.en_short}} 서비스 인스턴스를 선택하세요.
  9. 엔드포인트 유형을 공용 또는 비공개로 선택합니다. 자세한 내용은 Event Notifications 위한 서비스 엔드포인트를 참조하세요
  10. 연결을 확인하려면 저장을 클릭합니다.

다음 이름으로 IBM Cloud Event Notifications 소스가 생성됩니다.

IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID>

예를 들어, IBM Cloud Event Notifications 소스 이름은 다음과 같습니다

IBM Cloud Logs - rfdt3147-484f-4dee-b3c7-ab0c85a8e5c7

아웃바운드 통합의 이름은 IBM Cloud Event Notifications 인스턴스에서 소스의 이름을 지정하는 데 사용되지 않습니다.

연결 테스트

IBM Cloud Logs 에 대한 알림을 사용 설정한 후 연결을 테스트하여 IBM Cloud Logs 에서 생성된 이벤트가 Event Notifications 로 전달되는지 확인합니다.

먼저, Event Notifications 에서 다음 단계를 완료하십시오

  1. IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID> 라는 이름의 소스가 IBM Cloud Event Notifications 스에 생성되어 있는지 확인하십시오.

    1. 소스를 선택합니다.
    2. IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID> 라는 이름의 소스를 찾으십시오.
  2. 이 클라우드 로그 인스턴스를 소스로 지정하고 "이벤트 유형"을 "테스트 이벤트"로 범위 지정한 주제를 만듭니다.

    1. 주제를 선택하십시오. 그런 다음 작성을 클릭하십시오.
    2. CloudLogsInstance-test 와 같은 주제 이름을 입력하세요.
    3. 통합을 테스트하려는 인스턴스의 소스 IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID> 를 선택합니다.
    4. 이벤트 유형 테스트 이벤트를 선택합니다.
    5. 조건 추가 선택 > 소스 저장.
    6. 작성을 클릭하십시오.
  3. 목적지를 만들고 목적지가 설정되었는지 확인합니다. 예를 들어, 슬랙(Slack)이나 이메일로 전송되도록 설정할 수 있습니다.

  4. 주제와 대상을 페어링하는 구독을 만듭니다.

    1. 이름을 입력하세요(예: Test integration ).
    2. CloudLogsInstance-test 를 선택하십시오.
    3. 목적지를 선택하세요.
    4. 작성을 클릭하십시오.

다음으로, IBM Cloud Logs 에서 다음 단계를 완료하십시오

  1. 아웃바운드 통합을 편집합니다.
  2. 테스트를 클릭하십시오.
  3. 선택한 목적지를 확인하고 테스트 이벤트가 전송되었는지 확인하십시오.