워크플로 멘션 이름을 사용하여 워크플로를 검색하고 드롭다운에서 선택합니다. 모니터 트리거가 있는 워크플로만 목록에 나타납니다. 입력 파라미터가 없는 경우 @workflow-name 형식으로, 입력 파라미터가 있는 경우 @workflow-name(param="") 형식으로 알림 메시지 필드에 모니터용 멘션이 표시됩니다.
워크플로가 입력 파라미터를 사용하는 경우 다음 단계를 따르세요.
모니터 이름 및 ID 옆의 Configure Inputs를 클릭합니다.
Enter values for the input parameters. Note: Values can include monitor message template variables. To see a list of available variables, click Use Message Template Variables in the upper-right of the Configure notifications & automations section. The parameters populate in the mention within the notification message field. For example, if you configure a workflow named @workflow-test-inputs to have the following parameters:
the mention changes to @workflow-test-inputs(im_a_string="abc", im_a_number=123, im_a_boolean=true, i_have_a_default_value="override this").
인시던트 트리거는 인시던트 이벤트를 기반으로 워크플로를 자동으로 실행하거나, 인시던트 내에서 수동으로 실행할 수 있습니다.
인시던트 컨텍스트가 기본 제공되고 추가 요금이 부과되지 않는 Incident Management 내 인시던트 자동화를 설정하려면 Incident Automations를 참조하세요. 인시던트 이벤트가 여러 트리거 중 하나이거나 워크플로가 Incident Management 외부에서 관리되는 경우 인시던트 트리거가 포함된 워크플로를 사용하세요.
Matches regular expression: 메시지가 Message pattern에 입력한 정규식과 일치해야 합니다. 대소문자를 구분하며, 메시지 내 어느 위치에서든 패턴이 일치하면 됩니다. 전체 메시지와 일치시키려면 ^와 $를 사용하세요(예: ^deploy\s+production$). 대소문자를 구분하지 않으려면 패턴 시작 부분에 (?i)을 추가하세요.
필요시 다음과 같이 대상 메시지를 필터링할 수 있습니다.
Thread replies: Include all messages, Only thread replies 또는 Exclude thread replies.
App messages: Include all messages, Only app messages 또는 Exclude app messages.
다른 패턴이나 채널을 수신하려면 Add message rule을 클릭합니다. 메시지가 두 개 이상의 규칙과 일치하는 경우 워크플로는 한 번만 실행됩니다.
Save를 클릭한 다음 Publish를 클릭합니다.
Slack 메시지 액세스
워크플로의 이후 단계에서 Source.slack_message를 사용하여 워크플로를 트리거한 메시지를 참조하세요.
변수
설명
Source.slack_message.text
메시지의 텍스트입니다.
Source.slack_message.user_id
메시지를 게시한 사용자의 Slack ID입니다(있는 경우).
Source.slack_message.channel_id
메시지가 게시된 채널의 Slack ID입니다.
Source.slack_message.team_id
작업 공간의 Slack ID입니다.
Source.slack_message.message_ts
메시지의 Slack 타임스탬프입니다.
Source.slack_message.thread_ts
메시지가 스레드 답글인 경우 상위 메시지의 Slack 타임스탬프입니다.
Source.slack_message.app_id
앱에서 메시지를 게시한 경우 해당 앱의 Slack ID입니다.
Source.slack_message.bot_id
봇에서 메시지를 게시한 경우 해당 봇의 Slack ID입니다.
API 트리거
API 호출을 사용하여 워크플로를 트리거하려면 API 키와 workflows_run 범위가 포함된 애플리케이션 키가 필요합니다. 애플리케이션 키에 범위를 추가하는 방법에 대한 자세한 내용은 범위를 참조하세요.
범위가 지정되지 않은 키에는 workflows_run 해당 범위가 기본적으로 포함되지 않습니다. 보안 모범 사례를 따르고 원하는 작업을 수행하는 데 필요한 최소한의 범위가 포함된 애플리케이션 키를 사용하세요.
워크플로 ID가 포함된 POST 요청을 엔드포인트 https://api.datadoghq.com/api/v2/workflows/WORKFLOW-ID/instances로 보내 워크플로를 트리거할 수 있습니다. 워크플로에 API 트리거를 추가하면 트리거 인터페이스에서 워크플로를 트리거하는 데 사용할 수 있는 cURL 요청 예시를 제공합니다.
워크플로에 API 트리거를 추가하려면 다음 단계를 따르세요.
Add Trigger > API를 클릭합니다.
워크플로 캔버스에서 API를 클릭하고 워크플로를 트리거하는 데 필요한 헤더와 데이터가 포함된 예시 워크플로 cURL 요청을 확인합니다.
Publish를 클릭하여 워크플로를 게시합니다. POST 요청으로 워크플로를 트리거하려면 먼저 워크플로를 게시해야 합니다. 게시된 워크플로는 워크플로 실행 횟수를 기준으로 비용이 발생합니다. 자세한 내용은 Datadog 비용 페이지를 참조하세요.
API 요청 본문 액세스
워크플로의 이후 단계에서 Source.api.requestBody를 사용하여 들어오는 API 요청의 페이로드를 참조합니다. 요청 본문이 JSON인 경우, 개별 필드에 액세스하기 전에 JSON.parse()로 구문 분석합니다. 예를 들어 Source.api.requestBody.my_field 대신 ${JSON.parse(Source.api.requestBody).my_field}를 사용합니다.
예약된 트리거
워크플로 실행을 예약하려면 다음 단계를 따르세요.
워크플로 캔버스에서 Add an Automated Trigger를 클릭하고 Schedule을 선택합니다.
Create를 클릭하여 서비스 계정을 만듭니다. 자세한 내용은 서비스 계정으로 실행을 참조하세요.
실행 시간과 빈도를 입력합니다.
(선택 사항) Memo 필드에 워크플로에 대한 설명을 입력합니다.
Save를 클릭합니다.
Publish를 클릭합니다. 예약된 워크플로는 게시하기 전까지 실행되지 않습니다. 게시된 워크플로는 워크플로 실행 횟수를 기준으로 비용이 발생합니다. 자세한 내용은 Datadog 비용 페이지를 참조하세요.
다른 워크플로에서 워크플로 트리거
Trigger Workflow 작업을 사용하여 다른 워크플로에서 자식 워크플로를 트리거할 수 있습니다. 예를 들어 여러 워크플로에서 재사용해야 하는 복잡한 일련의 단계가 있는 경우, 모든 워크플로에 대해 해당 단계를 다시 만들 필요가 없습니다. 대신 단계를 새 워크플로에 추가하고 Trigger Workflow 작업을 사용하여 다른 워크플로에서 트리거하세요.
요금 청구 시 자식 워크플로를 트리거하면 별도의 워크플로 실행으로 집계됩니다.
자식 워크플로에 입력 파라미터가 있는 경우, 이러한 파라미터는 Trigger Workflow 작업에서 필수 필드로 나타납니다. 아래 예시에서 service_name이 자식 워크플로의 입력 파라미터로 설정되어 있으므로 service_name 입력 파라미터가 필요합니다.
자식 워크플로의 결과 액세스
자식 워크플로에서 Output parameters를 정의하여 자식 워크플로의 결과를 부모 워크플로로 다시 전달할 수 있습니다. 부모 워크플로에서 WorkflowOutputs 컨텍스트 변수를 사용하여 자식 워크플로의 출력 파라미터를 검색하세요. 예를 들어 exampleList라는 출력 파라미터가 있는 Example_workflow라는 자식 워크플로가 있는 경우, Steps.Example_workflow.workflowOutputs.exampleList를 사용하여 자식 워크플로의 결과에 액세스하세요.
실행 기록
워크플로를 트리거하면 워크플로 페이지가 해당 워크플로의 Run History로 전환됩니다. 왼쪽 상단에서 Configuration 또는 Run History를 클릭하여 구성 조회와 실행 기록 조회 간에 전환하세요. 실행 기록을 사용하여 트리거된 워크플로의 진행 상황을 확인하거나 실패한 단계를 디버깅하세요.