IBM Cloud Logs 의 조치를 사용하여 써드파티 서비스와 통합

IBM Cloud Logs 에서 검색 결과와 값을 기반으로 타사 서비스를 트리거하고 해당 서비스로 데이터를 전송할 수 있습니다. 뷰 및 대시보드에서 관리 작업을 만들 수 있습니다.

액션 작성

조치를 작성하려면 다음을 수행하십시오.

  1. 왼쪽 탐색에서 로그 탐색 아이콘 로그 탐색 아이콘 > 로그를 클릭하십시오.

  2. 로그 보기에서 설정 아이콘 설정을 클릭하십시오. 이 설정 아이콘은 왼쪽 탐색의 아이콘과 동일하지 않습니다. 설정 아이콘은 페이지의 오른쪽 상단에 있는 로그 보기에서 찾을 수 있습니다.

  3. 조치 관리를 클릭하십시오.

  4. 새 조치 추가를 클릭하십시오.

  5. 제목이 없는 조치에 대해 조치의 이름을 지정하십시오.

  6. URL 템플릿에 외부 서비스용 URL 을 입력합니다. 예를 들어, https://test-my-url.com?type={{ $m.subsystemName === "frontend" ? "Front" : "Back" }}입니다. http:// 및 https:// 만 지원됩니다.

    JavaScript 구문이 지원됩니다. 예를 들어, {{ condition ? "true value" : "false value" }} 와 같은 조건을 지정할 수 있습니다. 대부분의 JavaScript 함수가 지원됩니다.

    변수를 포함시켜 URL 에 데이터를 전달할 수 있습니다. 이중 중괄호 ({{}}) 를 입력하면 사용 가능한 변수 목록이 표시됩니다.

  7. 조치와 연관된 데이터 유형 을 선택하십시오. 선택한 컨텍스트에 조치가 표시됩니다.

  8. 선택적 설정에 액세스하려면 고급 을 클릭하십시오.

  9. 조치를 공용으로 설정하려면 저장 시 공용으로 설정을 전환하십시오.

  10. 특정 애플리케이션 또는 서브시스템으로 조치를 제한하려면 목록에서 값을 선택하십시오.

  11. 조치 저장 을 클릭하십시오.

조치 편집

기존 작업을 편집하려면 다음과 같이 하세요:

  1. 왼쪽 탐색에서 로그 탐색 아이콘 로그 탐색 아이콘 > 로그를 클릭하십시오.

  2. 로그 보기에서 설정 아이콘 설정을 클릭하십시오. 이 설정 아이콘은 왼쪽 탐색의 아이콘과 동일하지 않습니다. 설정 아이콘은 페이지의 오른쪽 상단에 있는 로그 보기에서 찾을 수 있습니다.

  3. 조치 목록에서 변경할 조치를 클릭하십시오.

  4. 변경을 수행하십시오.

  5. 조치 저장 을 클릭하여 변경사항을 저장하거나 재설정 을 클릭하여 조치를 마지막으로 저장된 조치 버전으로 되돌리십시오.

조치 복제

기존 조치를 기반으로 새 조치를 작성하려는 경우 조치를 복제할 수 있습니다.

  1. 왼쪽 탐색에서 로그 탐색 아이콘 로그 탐색 아이콘 > 로그 를 클릭하십시오.

  2. 로그 보기에서 설정 아이콘 설정을 클릭하십시오. 이 설정 아이콘은 왼쪽 탐색의 아이콘과 동일하지 않습니다. 설정 아이콘은 페이지의 오른쪽 상단에 있는 로그 보기에서 찾을 수 있습니다.

  3. 조치 목록에서 복제할 조치 위로 마우스를 이동하십시오.

  4. 복제 아이콘을 클릭합니다. 조치의 복제본이 작성됩니다.

  5. 복제된 조치를 편집 하고 변경하십시오.

  6. 작업 저장을 클릭하여 변경 사항을 저장합니다.

조치 메뉴에서 조치 표시 및 숨기기

사용자가 조치를 트리거 할 수 있는지 여부를 구성할 수 있습니다.

  1. 왼쪽 탐색에서 로그 탐색 아이콘 로그 탐색 아이콘 > 로그를 클릭하십시오.

  2. 로그 보기에서 설정 아이콘 설정을 클릭하십시오. 이 설정 아이콘은 왼쪽 탐색의 아이콘과 동일하지 않습니다. 설정 아이콘은 페이지의 오른쪽 상단에 있는 로그 보기에서 찾을 수 있습니다.

  3. 작업 목록에서 구성하려는 작업을 클릭합니다.

  4. 조치 메뉴에 사용자에 대한 조치가 포함되지 않도록 하려면 조치 메뉴에서 숨기기 아이콘을 클릭하십시오. 조치가 조치 메뉴에 포함되도록 하려면 조치 메뉴에 표시 아이콘을 클릭하십시오.

조치 트리거

다음 단계를 수행하여 조치를 트리거하십시오.

  1. 왼쪽 탐색에서 로그 탐색 아이콘 로그 탐색 아이콘 > 로그를 클릭하십시오.

  2. 보기에서 표시된 데이터를 클릭하십시오. 메뉴가 표시됩니다.

  3. 조치 위로 마우스를 이동하십시오. 사용 가능한 작업 목록이 표시됩니다.

  4. 조치를 클릭하여 조치를 트리거하십시오.

    조치 메뉴에 표시 되도록 구성된 조치만 조치 메뉴에 나열됩니다.

조치 삭제

  1. 왼쪽 탐색에서 로그 탐색 아이콘 로그 탐색 아이콘 > 로그를 클릭하십시오.

  2. 로그 보기에서 설정 아이콘 설정을 클릭하십시오. 이 설정 아이콘은 왼쪽 탐색의 아이콘과 동일하지 않습니다. 설정 아이콘은 페이지의 오른쪽 상단에 있는 로그 보기에서 찾을 수 있습니다.

  3. 조치 목록에서 삭제할 조치를 클릭하십시오.

  4. 삭제를 클릭하십시오.

    삭제는 즉시 수행됩니다. 조치를 삭제할 것인지 확인하는 메시지가 표시되지 않습니다.

조치에 포함될 수 있는 변수

URL 템플릿에서 변수를 지정하여 외부 서비스에 정보를 전달할 수 있습니다.

지원되는 변수는 다음과 같습니다:

$m.<metadata>
메타데이터 변수는 로그에서 사용 가능합니다. 예를 들어, $m.applicationName 또는 $m.timestamp입니다.
$d.<key>.<subkey>
로그에서 사용 가능한 데이터입니다. 예를 들어, $d.kubernetes.labels.my_label입니다.
$p.start_time
선택한 시간 범위의 시작을 Unix 에포크 타임스탬프(밀리초 단위)로 표시합니다.
$p.end_time
선택한 시간 범위의 끝을 Unix 에포크 타임스탬프(밀리초 단위)로 표시합니다.
$p.selected_value
UI에서 사용자가 선택한 값입니다. 키를 클릭하여 활성화하면 키의 전체 값이 포함됩니다.

예제 조치

다음 조치는 Jira 문제를 생성합니다.

http://<company_name>.atlassian.net//secure/CreateIssueDetails!init.jspa?pid=<Jira_PID>&issuetype=<Jira_issueType>&description={{$d.logRecord.body}}&summary={{$d.msg}}