Docs Menu
Docs Home
/
MongoDB Atlas
/

타사 서비스와 통합합니다.

이 페이지의 내용

  • 필요한 액세스 권한
  • 타사 설정 보기 또는 수정

Atlas를 타사 모니터링 서비스와 통합하여 다양한 외부 모니터링 서비스에서 Atlas 경고를 수신하고, Atlas가 클러스터에 대해 수집하는 성능 지표를 확인 및 분석할 수 있습니다.

참고

현재서버리스 인스턴스 지표 지원 타사 서비스( 예시: Datadog ).

타사 통합 설정을 보려면 프로젝트에 대한 Organization Owner 또는 Project Owner 액세스 권한이 있어야 합니다.

참고

Atlas CLI 명령을 실행하기 전에 다음을 수행해야 합니다.

Atlas CLI를 사용하여 Datadog 통합을 만들거나 업데이트하려면 다음 명령을 실행하세요:

atlas integrations create DATADOG [options]

명령 구문 및 매개 변수에 대한 자세한 내용은 Atlas 통합 생성 DATADOG에 대한 Atlas CLI 설명서를 참조하세요.

Atlas CLI를 사용하여 Opsgenie 통합을 만들거나 업데이트하려면 다음 명령을 실행하세요:

atlas integrations create OPS_GENIE [options]

명령 구문 및 매개 변수에 대한 자세한 내용은 Atlas 통합 생성 OPS_GENIE에 대한 Atlas CLI 문서를 참조하세요.

Atlas CLI를 사용하여 PagerDuty 통합을 만들거나 업데이트하려면 다음 명령을 실행하세요:

atlas integrations create PAGER_DUTY [options]

명령 구문 및 매개변수에 대해 자세히 알아보려면 Atlas 통합 생성 PAGER_DUTY에 대한 Atlas CLI 설명서를 참조하세요.

Atlas CLI를 사용하여 VictorOps 통합을 만들거나 업데이트하려면 다음 명령을 실행하세요:

atlas integrations create VICTOR_OPS [options]

명령 구문 및 매개변수에 대한 자세한 내용은 Atlas 통합 생성 VICTOR_OPS에 대한 Atlas CLI 문서를 참조하세요.

Atlas CLI를 사용하여 웹훅 통합을 만들거나 업데이트하려면 다음 명령을 실행하세요.

atlas integrations create WEBHOOK [options]

명령 구문 및 매개변수에 대한 자세한 내용은 Atlas 통합 생성 WEBHOOK에 대한 Atlas CLI 설명서를 참조하세요.

Atlas CLI를 사용하여 프로젝트의 모든 타사 통합을 나열하려면 다음 명령어를 실행합니다.

atlas integrations list [options]

Atlas CLI를 사용하여 하나의 타사 통합에 대한 세부 정보를 반환하려면 다음 명령을 실행합니다.

atlas integrations describe <integrationType> [options]

이전 명령의 구문과 매개 변수에 대한 자세한 내용은 Atlas CLI 설명서에서 atlas integrations listatlas integrations describe를 참조하세요.

참조: 관련 링크

Atlas CLI를 사용하여 타사 통합 서비스를 삭제하려면 다음 명령을 실행하세요:

atlas integrations delete <integrationType> [options]

명령 구문 및 매개변수에 대해 자세히 알아보려면 Atlas 통합 삭제에 대한 Atlas CLI 설명서를 참조하세요.

참조: 관련 링크

Atlas UI를 사용하여 타사 통합 설정을 수정하려면

1
  1. 아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

  2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

  3. Projects 메뉴 옆에 있는 Options 메뉴를 펼친 다음 Integrations 를 클릭합니다.

    프로젝트 통합 페이지가 표시됩니다.

2

수정하려는 타사 서비스에 대해 Configure을(를) 클릭합니다. 다음 중 하나 이상을 설정할 수 있습니다.

타사 서비스
구성 세부 정보
Datadog Settings

배포서버에 대한 지표 데이터를 Datadog로 보내도록 Atlas를 구성합니다. Datadog 대시보드에서 이러한 지표를 볼 수 있습니다. Datadog이 추적하는 모든 Atlas 지표의 세부 목록을 확인하려면 Datadog 통합 페이지를 참조하세요.

  • Datadog 계정이 있는 경우 Datadog를 사용하여 Atlas 메트릭 데이터 추적을 시작합니다.

  • 기존 Datadog 계정이 없는 경우 가입할 수 있습니다.

  • Datadog API 키

  • API 리전

    Atlas는 Atlas UI에서 다음과 같은 Datadog 리전을 지원합니다.

    • US1

    • US3

    • US5

    • EU1

    • AP1

    Datadog은 US1 디폴트로 사용합니다.

    Datadog 리전에 대해 자세히 알아보려면 Datadog 사이트를 참조하세요.

Microsoft Teams Settings

프로젝트에 대한 경고를 Microsoft Teams 채널에 보내도록 Atlas를 구성합니다. 채널에 표시되는 적응형 카드에서 이러한 경고를 볼 수 있습니다.

Microsoft Teams 채널에 경고 알림을 전송하려면 Microsoft Teams 수신 웹훅 (webhook)을 생성해야 합니다. 웹훅 (webhook)을 생성한 후 자동으로 생성된 URL을 사용하여 Atlas에서 Microsoft Teams 통합을 구성할 수 있습니다.

통합을 설정하려면 Integrate with Microsoft Teams 참조합니다.

New Relic Settings

중요: 2021년 6월 16일 수요일부터 New Relic은 더 이상 MongoDB와의 플러그인 기반 통합을 지원하지 않습니다. 플러그인 기반 통합에 등록하지 않는 것이 좋습니다. 자세한 내용은 New Relic 플러그인 EOL 정책을 참조하세요.

배포서버에 대한 지표 데이터를 Datadog로 보내도록 Atlas를 구성합니다. New Relic MongoDB 플러그인을 통해 볼 수 있습니다. 또한 Insights for New Relic를 사용하여 수집된 데이터에 대한 분석을 실행할 수 있습니다. Atlas는 Atlas 클러스터 지표에 표시된 것과 동일한 메트릭 데이터를 뉴렐릭에 보냅니다.

  • New Relic 계정이 있는 경우 다음 정보를 입력하세요.

    • 계정 ID

    • 라이선스 키

    • Insights API 삽입 키

    • 인사이트 API 쿼리 키

  • New Relic 계정이 없다면가입하세요.

나중에 키가 유효하지 않게 되면 Atlas는 프로젝트 소유자에게 이메일을 보내고 결국 유효하지 않은 자격 증명을 제거합니다.

OpsGenie API Key

OpsGenie Alert API에 대한 API 키를 설정합니다. 알림을 구성할 때 이 키가 기본 OpsGenie API 키로 사용됩니다. (이 통합은 팀이 아닌 구성된 계정으로 알림을 보냅니다.)

  • OpsGenie 계정이 있는 경우 다음 정보를 입력하세요.

    • OpsGenie가 API 통합을 생성한 후 제공하는 OpsGenie 통합 API 키 OpsGenie 팀 소속입니다. Atlas 통합에는 일반 OpsGenie 계정 API 키를 사용할 수 없습니다.

    • API 리전 (미국 또는 유럽)

  • OpsGenie 계정이 없으면 계정을 등록하세요.

PagerDuty Service Key

PagerDuty 계정으로 전송되는 경고 알림의 기본 서비스 키를 설정합니다. Atlas는 경고 구성에 PagerDuty 알림을 추가할 때 기본적으로 키를 입력합니다. PagerDuty 알림을 추가하고 알림을 보내는 데 사용된 키가 유효하지 않게 되면 Atlas는 프로젝트 소유자에게 이메일을 보내고 결국 키를 제거합니다.

사용자는 PagerDuty 대시보드에서만 PagerDuty 경고를 확인할 수 있습니다.

모든 새 PagerDuty 키는 이벤트 API v2를 사용합니다.

이벤트 API v1 키가 있는 경우 Atlas에서 해당 키를 계속 사용할 수 있습니다.

Slack Settings

Slack 계정으로 전송되는 경고 알림에 대한 팀 이름, API 토큰 및 채널 이름을 설정합니다. OAuth2와 Slack 통합을 구성하려면 Configure을(를) 클릭한 다음 Sign in with Slack을(를) 클릭합니다.

로그인하면 워크스페이스를 선택하고 권한을 구성할 수 있는 Slack 랜딩 페이지로 이동합니다. Slack을 Atlas에 연결하도록 구성하면 API 토큰이 자동으로 생성되고 유지됩니다. Atlas는 사용자를 Integrations page로 리디렉션합니다.

Atlas로 Slack을 처음 구성한 후 Edit 또는 Remove 통합을 수행할 수 있습니다. 통합을 편집하면 Atlas에 팀 이름과 API 토큰이 표시되고 채널 이름을 변경할 수 있습니다.

중요: Atlas는 레거시 토큰을 더 이상 사용하지 않습니다. 레거시 토큰으로는 새로운 Slack 통합을 구성하거나 레거시 토큰을 편집할 수 없습니다. Atlas에서 레거시 토큰을 더 이상 사용하지 않기 전에 레거시 토큰을 사용하여 Slack 통합을 구성한 경우 계속해서 레거시 토큰을 사용할 수 있습니다. 그러나 토큰 구성을 편집해야 하는 경우 OAuth2 와 Slack 통합을 다시 구성해야 합니다.

SumoLogic Settings
Atlas로 SumoLogic을 구성하기 위한 관련 SumoLogic 설명서로 연결됩니다. SumoLogic 통합을 설정하기 위해 Atlas 내에서 설정을 구성할 필요가 없습니다.
VictorOps Settings

Splunk On-Call(이전의 VictorOps) 계정으로 전송되는 경고 알림에 대한 API 키 및 라우팅 키를 설정합니다. Atlas는 경고를 구성할 때 이 정보를 기본 설정으로 사용합니다.

Webhook Settings

Atlas가 프로그래밍 방식 처리에 대한 경고 알림을 보낼 수 있는 Webhook URL 엔드포인트를 추가합니다. Atlas는 경고 알림을 HTTP POST 요청으로 보냅니다. 요청 본문에는 Atlas 관리 API Alerts 리소스와 동일한 형식을 사용하는 JSON 문서가 포함되어 있습니다.

Atlas는 다양한 경고 상태를 구분하기 위해 X-MMS-Event 요청 헤더를 추가합니다. 이 헤더에 사용할 수 있는 값은 다음과 같습니다.

alert.open
경고가 방금 열렸습니다.
alert.close
경고가 해결되었습니다.
alert.update
이전에 열린 경고는 여전히 열려 있습니다.
alert.acknowledge
경고가 승인되었습니다.
alert.cancel
경고가 유효하지 않게 되어 취소되었습니다.
alert.inform
"Primary Elected"와 같은 연속 클라우드 백업 이벤트인 정보 경고를 나타냅니다.

Webhook Secret 필드에 키를 지정하면 Atlas가 X-MMS-Signature 요청 헤더를 추가합니다. 이 헤더에는 요청 본문의 Base64인코딩 HMAC-SHA-1 서명이 포함되어 있습니다. Atlas는 제공된 쿠버네티스 시크릿을 사용하여 서명을 생성합니다.

Webhook에 경고 알림을 보내려면 알림을 만들거나 편집할 때 Webhook 알림 옵션을 선택합니다. Webhook 알림을 추가했는데 URL 또는 선택적 키가 유효하지 않게 되면 Atlas는 프로젝트 소유자에게 이메일을 보내고 결국 Webhook 설정을 제거합니다.

중요: 방화벽 구성에 필요한 경우 Atlas가 웹훅과 통신할 수 있도록 Atlas IP 주소에서의 액세스를 허용하세요.

Prometheus Settings
배포서버에 대한 지표 데이터를 Prometheus 인스턴스로 보내도록 Atlas를 구성합니다. 자세한 내용은 Prometheus와의 통합을 참조하세요.

참고

서비스를 위한 유럽 통합 지점을 이 표에서 찾을 수 없으면 Atlas에서 이를 지원하지 않는 것입니다. 현재 OpsGenieDataDog만 별도의 유럽 통합 지점을 제공합니다.

돌아가기

사용 가능한 메트릭