복제 및 장애 조치 그룹에 대한 오류 알림

기본 복제 또는 장애 조치 그룹에 대한 알림 통합을 설정하여 새로 고침 작업 실패에 대한 오류 알림을 받을 수 있습니다.

새로 고침 작업 실패에 대한 오류 알림

복제 또는 장애 조치 그룹에 대해 오류 알림을 사용 설정하면 새로 고침 작업이 실패하면 지정된 이메일, 클라우드 메시징 서비스 또는 웹훅을 통해 알림이 전송됩니다.

알림에는 다음 정보가 포함됩니다.

  • 소스 및 대상 계정 이름.

  • 소스 및 대상 리전(및 해당하는 경우 리전 그룹).

  • 기본 및 보조 복제 또는 장애 조치 그룹 이름.

  • 오류가 발생한 타임스탬프.

  • 오류 코드 및 메시지.

  • 소스 및 대상 로그인 URL.

오류 알림 및 장애 조치

알림은 기본 복제 또는 장애 조치 그룹에서 사용 설정되며 알림 통합을 사용하여 전송됩니다. 알림 통합은 대상 계정에 복제할 필요가 없습니다. 장애 조치의 경우 알림 통합이 복제되었거나 동일한 이름의 기존 알림 통합이 있는 경우 새로 승격된 소스 계정에서 오류 알림이 계속 전송됩니다.

알림 통합 기능을 사용할 수 없는 경우 새로 고침 작업 실패에 대한 오류 알림이 전송되지 않습니다.

전제 조건: 오류 알림을 위한 알림 통합

오류 알림을 보내려면 알림 통합이 필요합니다. 새로 고침 작업 실패에 대한 이메일 알림을 보내려면 알림 통합이 다음 유형 중 하나여야 합니다.

TYPE = EMAIL:

이메일 알림 통합을 사용하려면 DEFAULT_RECIPIENTS 목록에 인증된 이메일 주소가 하나 이상 있어야 합니다.

기본 수신자 목록이 포함된 이메일 알림을 만드는 방법에 대한 자세한 내용은 기본 수신자 목록 및 기본 제목줄 지정 섹션을 참조하십시오.

TYPE = QUEUE:

Snowflake에서 지원하는 모든 클라우드 공급자에 대해 메시징 서비스로 알림을 푸시하도록 구성된 알림 통합을 사용할 수 있습니다. 알림 통합 TYPE 매개 변수를 QUEUE 로 설정하고 DIRECTION 매개 변수를 OUTBOUND 로 설정해야 합니다.

자세한 내용은 클라우드 공급자 큐(Amazon SNS, Google Cloud PubSub 및 Azure Event Grid)에 알림 보내기 섹션을 참조하십시오.

TYPE = WEBHOOK:

Snowflake에서 지원하는 모든 외부 시스템에 대해 웹훅으로 알림을 푸시하도록 구성된 알림 통합을 사용할 수 있습니다. 알림 통합 TYPE 매개 변수를 WEBHOOK 으로 설정합니다. 외부 시스템에서 요구 사항이 있는 경우 시크릿을 생성해야 할 수도 있습니다.

자세한 내용은 웹훅 알림 보내기 섹션을 참조하십시오.

알림 통합 만들기(TYPE = EMAIL)

이메일 주소 first.last@example.com 으로 my_notification_int 라는 이메일 알림 통합을 생성하려면 다음 단계를 따르십시오.

  1. 이메일 주소 first.last@example.com 로 확인되었는지 확인합니다.

  2. CREATE NOTIFICATION INTEGRATION 명령을 실행하여 알림 통합을 생성합니다. 예:

    CREATE NOTIFICATION INTEGRATION my_notification_int
      TYPE = EMAIL
      ENABLED = TRUE
      DEFAULT_RECIPIENTS = ('first.last@example.com');
    
    Copy

알림 통합 만들기(TYPE = QUEUE)

클라우드 공급자 큐에 알림을 푸시하기 위한 알림 통합을 생성하려면 현재 지원되는 클라우드 공급자 큐에 대해 제공되는 지침을 따르십시오.

알림 통합 만들기(TYPE = WEBHOOK)

외부 시스템 웹훅으로 알림을 푸시하기 위한 알림 통합을 생성하려면 현재 지원되는 외부 시스템 웹훅에 대해 제공되는 지침을 따르십시오.

중요

웹훅 알림 통합은 WEBHOOK_BODY_TEMPLATE 매개 변수를 SNOWFLAKE_WEBHOOK_MESSAGE 를 자리 표시자 값으로 지정해야 합니다. 알림이 전송되면 새로 고침 작업 실패에 대한 오류 알림 에 설명된 대로 자리 표시자가 복제 오류 알림의 내용으로 바뀝니다.

WEBHOOK_BODY_TEMPLATE 지정 형식은 외부 시스템에 따라 다릅니다.

  • Slack 또는 Microsoft Teams의 경우 WEBHOOK_BODY_TEMPLATE 은 다음과 같은 단일 값 JSON 오브젝트 형식을 값으로 사용합니다.

    WEBHOOK_BODY_TEMPLATE='{"text": "SNOWFLAKE_WEBHOOK_MESSAGE"}'
    
    Copy
  • PagerDuty 의 경우 WEBHOOK_BODY_TEMPLATE 은 다중 값 JSON 오브젝트를 값으로 사용하지만, 표준 PagerDuty 알림 통합과 다음과 같은 차이점이 있습니다.

    • payload 키 내에서, summary 키는 SNOWFLAKE_WEBHOOK_MESSAGE 를 지정하는 데 사용되지 않습니다.

    • 대신, 추가 custom_details 키를 사용하여 SNOWFLAKE_WEBHOOK_MESSAGE 를 지정하십시오.

    예:

    WEBHOOK_BODY_TEMPLATE='{
      "routing_key": "SNOWFLAKE_WEBHOOK_SECRET",
      "event_action": "trigger",
      "payload": {
        "summary": "Snowflake replication failure",
        "source": "Snowflake monitoring",
        "severity": "INFO",
        "custom_details": {
          "message": "SNOWFLAKE_WEBHOOK_MESSAGE"
        }
      }
    }'
    
    Copy

복제 또는 장애 조치 그룹에 대한 오류 알림 추가

기존 복제/장애 조치 그룹에 대한 오류 알림을 사용하려면 ALTER REPLICATION GROUP 또는 ALTER FAILOVER GROUP 명령을 사용하여 ERROR_INTEGRATION 매개 변수를 설정합니다.

예를 들어, 알림 통합 my_notification_int 를 장애 조치 그룹 my_fg 에 추가합니다. 소스 계정에서 다음 문을 실행해야 합니다.

ALTER FAILOVER GROUP my_fg SET
  ERROR_INTEGRATION = my_notification_int;
Copy

복제/장애 조치 그룹을 만들고 오류 알림을 사용 설정하려면 CREATE REPLICATION GROUP 또는 CREATE FAILOVER GROUP 명령을 사용하고 ERROR_INTEGRATION 매개 변수를 설정합니다.

예를 들어, 장애 조치 그룹 my_fg 를 만들어 데이터베이스 db1 의 복제와 장애 조치를 활성화하고, 장애 조치 그룹 db2 를 만들어 조직 myorg 의 계정 myaccount2myaccount2 를 활성화하려면, 소스 계정에서 다음 명령을 실행하여 기본 장애 조치 그룹을 만듭니다.

CREATE FAILOVER GROUP my_fg
  OBJECT_TYPES = DATABASES
  ALLOWED_DATABASES = db1, db2
  ALLOWED_ACCOUNTS = myorg.myaccount2, myorg.myaccount3
  REPLICATION_SCHEDULE = '10 MINUTE'
  ERROR_INTEGRATION = my_notification_int;
Copy

참고

복제 또는 장애 조치 그룹의 복제 일정이 높은 빈도(예: 1분)로 설정된 경우 예약된 모든 새로 고침 작업에 대해 동일한 문제에 대한 오류 알림이 전송됩니다.