애플리케이션에서 전송하는 이메일을 완전히 제어할 권한이 있는 경우, JSON 형식 메시지를 전송할 수 있습니다. 이메일 본문은 Events API v1(POST /api/v1/events)의 JSON 구조를 따라야 합니다. v1 API 버전을 선택하여 요청 본문 필드를 확인하세요. 이메일 본문의 JSON은 Datadog에 표시되는 이벤트 필드를 설정합니다.

소스 이메일

JSON 형식 이메일을 사용하면 다음 필드를 제어할 수 있습니다.

• 발신자의 이메일 주소
• Events API v1에서 지원하는 모든 필드(예: title, text, tags, alert_type)

참고: JSON 형식이 올바르지 않거나 이메일이 제목 없이 전송되면 이벤트가 이벤트 스트림에 표시되지 않습니다.

Datadog 이벤트

JSON 형식 이메일에서는 이메일 제목이 이벤트에 표시되지 않습니다. 제목 속성 값이 이벤트 제목으로 사용됩니다. 이벤트에 표시되는 모든 데이터는 이메일 본문에서 JSON으로 정의되어야 합니다. 또한 본문은 올바른 형식의 순수 JSON이어야 하며, 그렇지 않을 경우 메시지가 무시됩니다. JSON으로 전송된 이벤트 예시:

참고: 표준 이메일 클라이언트로 이메일을 테스트하는 경우, 본문이 HTML로 변환될 수 있습니다. 이 경우 본문이 더 이상 순수 JSON이 아니게 되어 결과적으로 이메일이 무시됩니다.

애플리케이션에서 보낸 이메일을 제어할 권한이 부족한 경우에는 일반 텍스트 형식의 메시지를 사용하세요.

소스 이메일

일반 텍스트 형식의 이메일에서는 다음 필드를 제어할 수 있습니다.

예를 들어, 아래 이메일은 유효한 제출에 해당합니다.

Sender's email: matt@datadog.com
Subject: Env:Test - System at 50% CPU - #test
Body: This is a test message showing that env:test is at 50% CPU - #test

이메일 본문 처리

이메일 본문은 가독성과 보안을 강화하기 위해 여러 정리 단계를 거칩니다. 예상되는 변경 사항은 다음과 같습니다.

• HTML을 Markdown으로 변환: HTML 콘텐츠가 해당하는 Markdown으로 변환됩니다.
• HTML 새니타이징: 보안을 위해 이메일 본문은 새니타이징 처리되며, 특정 HTML 태그(a, br, caption, code, div, em, h1, h2, h3, h4, h5, h6, hr, iframe, img, li, ol, p, pre, span, strong, table, tbody, td, tfoot, th, thead, tr, ul)만 허용됩니다. <>로 묶인 문자열을 포함하여 다른 모든 HTML 태그는 삭제됩니다.
• 답장/전달 내용 제거: 스레드에서 가장 최근 이메일만 유지되며, 이전 답장 및 전달 내용은 삭제됩니다.

Datadog 이벤트

이메일 제목은 이벤트 제목이 되고, 이메일 본문은 이벤트 메시지가 됩니다. 이메일 발신자는 이벤트 하단에 표시됩니다. 메시지 본문에 #을 사용하여 태그를 추가할 수 있습니다.

Datadog은 이러한 기본 필드 한도를 초과하는 값을 잘라냅니다.

일반 텍스트로 전송된 이벤트 예시:

애플리케이션에서 전송하는 이메일을 완전히 제어할 권한이 있는 경우, JSON 형식 메시지를 전송할 수 있습니다. 이메일 본문은 Events API v2(POST /api/v2/events)의 JSON 구조를 따라야 합니다. 이메일 본문의 JSON은 Datadog에 표시되는 이벤트 필드를 설정합니다.

소스 이메일

JSON v2 형식 이메일을 사용하면 다음 필드를 제어할 수 있습니다.

• 발신자의 이메일 주소
• Events API v2에서 지원하는 모든 필드(예: data.attributes.title, data.attributes.message, data.attributes.tags, data.attributes.category)

경고 이벤트의 이메일 본문 예시입니다. 변경 및 정보 이벤트는 data.attributes.attributes 하위의 다른 필드를 사용합니다. 해당 카테고리에 대한 내용은 API 참조를 확인하세요.

{
  "data": {
    "attributes": {
      "category": "alert",
      "title": "CPU threshold exceeded",
      "message": "Host prod-web-01 averaged 92% CPU for five minutes.",
      "tags": [
        "env:production",
        "region:us-east"
      ],
      "integration_id": "custom-events",
      "attributes": {
        "status": "error",
        "priority": "3"
      }
    },
    "type": "event"
  }
}

참고: JSON 형식이 올바르지 않거나 이메일이 제목 없이 전송되면 이벤트가 이벤트 스트림에 표시되지 않습니다.

Datadog 이벤트

JSON v2 형식 이메일에서는 이메일 제목이 이벤트에 표시되지 않습니다. JSON 본문의 제목 필드 값이 이벤트 제목으로 사용됩니다. 이벤트에 표시되는 모든 데이터는 이메일 본문에서 JSON으로 정의되어야 합니다. 또한 본문은 올바른 형식의 순수 JSON이어야 하며, 그렇지 않을 경우 메시지가 무시됩니다.

참고: 표준 이메일 클라이언트로 이메일을 테스트하는 경우, 본문이 HTML로 변환될 수 있습니다. 이 경우 본문이 더 이상 순수 JSON이 아니게 되어 결과적으로 이메일이 무시됩니다.