Menu Docs
Página inicial do Docs
/
MongoDB Ops Manager
/ / / /

Criar uma configuração para uma integração de serviço de terceiros

Nesta página

  • Sintaxe
  • Parâmetros do caminho da solicitação
  • Solicitar parâmetros de query
  • Parâmetros do corpo da solicitação
  • Elementos de resposta
  • Exemplo de solicitação
  • Exemplo de resposta

Observação

Grupos e projetos são termos sinônimos. Seu {PROJECT-ID} é igual ao ID do seu projeto. Para grupos existentes, o ID do grupo/projeto permanece o mesmo. Esta página usa o grupo de termos mais conhecido ao se referir às descrições. O ponto final permanece conforme indicado no documento.

URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

POST /groups/{GROUP-ID}/integrations/{INTEGRATION-TYPE}
Parâmetro
necessidade
Descrição
{PROJECT-ID}
Obrigatório
Identificador do projeto.
{INTEGRATION-TYPE}
Obrigatório

Identificador de serviço de terceiros. Os valores aceitos são:

  • DATADOG

  • HIP_CHAT

  • PAGER_DUTY

  • SLACK

  • NEW_RELIC

  • OPS_GENIE

  • VICTOR_OPS

  • WEBHOOK

Nome
Tipo
necessidade
Descrição
Default
pageNum
número
Opcional
Um inteiro baseado que retorna uma subseção de resultados.
1
itemsPerPage
número
Opcional
Número de itens a serem devolvidos por página, até um máximo de 500.
100
pretty
booleano
Opcional
Sinalizador que indica se o corpo da resposta deve estar em um prettyprint formato.
false
envelope
booleano
Opcional

Sinalizador que indica se deseja ou não envolver a resposta em um envelope.

Alguns clientes do API não podem acessar os cabeçalhos de resposta HTTP ou o código de status. Para corrigir isso, configure envelope : true na consulta.

Para endpoints que retornam uma lista de resultados, o objeto results é um envelope. O Ops Manager adiciona o campo status ao corpo da resposta.

false
backupJobsEnabledOnly
booleano
Opcional
Sinalizador que indica se os daemon não habilitados para reconhecimento de data center devem ser excluídos da resposta. Defina isso como false para incluir configurações de daemon com o sinalizador backupJobsEnabled definido como false.
true

O corpo da solicitação deve ser uma única visualização de integração (como um objeto de configuração JSON ) para que um único serviço de terceiros seja adicionado ao projeto. Inclua sempre uma propriedade type igual ao serviço de terceiros INTEGRATION_TYPE.

Serviço, serviço
Opções de configuração
PagerDuty

Você deve fornecer os seguintes campos ao configurar uma integração PagerDuty:

Propriedade
Descrição
type
PAGER_DUTY
serviceKey

Sua chave de integração.

Importante

Alterar a Chave de Integração não altera nenhum alerta que usa essa integração. Esses alertas ainda usam a chave de integração anterior.

Remova e adicione novamente cada notificação PagerDuty para usar a nova chave.

PagerDuty descontinuado sua chave API REST v1 em outubro 2018. Se você tiver uma1 chave, poderá continuar a usar essa chave com o MongoDB Ops Manager. Todas as novas chaves PagerDuty usam sua REST API v2, mas MongoDB Ops Manager o não oferece suporte às2 chaves v . Se você não tiver a1 chave da API REST , use a API do PagerDuty Events v1 no lugar.

Depois de criar uma integração de terceiros que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:

  • Visualize ou edite o alerta por meio da UI.

  • Consulte as configurações de integração de terceiros por meio da API.

Slack

Importante

As integrações do Slack agora usam o método de verificação OAuth2 e devem ser configuradas inicialmente ou atualizadas a partir de uma integração legado , por meio dapágina de integrações de serviços de terceirosdo MongoDB Atlas .

Em breve, os tokens legados não serão mais suportados.

Você deve fornecer os seguintes campos ao reconfigurar uma integração existente do Slack:

Propriedade
Descrição
type
SLACK
apiToken

Seu token de API.

Depois de criar uma integração de terceiros que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:

  • Visualize ou edite o alerta por meio da UI.

  • Consulte as configurações de integração de terceiros por meio da API.

teamName
Nome da sua equipe.

Você também pode incluir os seguintes campos:

Propriedade
Descrição
channelName
O nome do canal a ser reconfigurado.
Datadog

Você deve fornecer os seguintes campos ao configurar uma integração do Datadog:

Propriedade
Descrição
type
DATADOG
apiKey

Sua chave de API.

Depois de criar uma integração de terceiros que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:

  • Visualize ou edite o alerta por meio da UI.

  • Consulte as configurações de integração de terceiros por meio da API.

HipChat

Você deve fornecer os seguintes campos ao configurar uma integração com o HipChat:

Propriedade
Descrição
type
HIP_CHAT
notificationToken

Token de notificação para sua conta de usuário do HipChat.

Depois de criar uma integração de terceiros que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:

  • Visualize ou edite o alerta por meio da UI.

  • Consulte as configurações de integração de terceiros por meio da API.

roomName
O nome da sua divisão no HipChat.
Opsgenie

Você deve fornecer os seguintes campos ao configurar uma integração Opsgenie:

Propriedade
Descrição
type
OPS_GENIE
apiKey

Sua chave de API.

Depois de criar uma integração de terceiros que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:

  • Visualize ou edite o alerta por meio da UI.

  • Consulte as configurações de integração de terceiros por meio da API.

region
Indica qual URL da API é usada, US ou EU. O Opsgenie usará US por padrão.

Para definir region como EU, você deve definir uma configuração de cliente de opsgenie.api.url.

VictorOps

Você deve fornecer os seguintes campos ao configurar uma integração VictorOps:

Propriedade
Descrição
type
VICTOR_OPS
apiKey

Sua chave de API.

Depois de criar uma integração de terceiros que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:

  • Visualize ou edite o alerta por meio da UI.

  • Consulte as configurações de integração de terceiros por meio da API.

Você também pode incluir os seguintes campos:

Propriedade
Descrição
routingKey
Um campo opcional para sua chave de roteamento.
Configurações do webhook

Você deve fornecer os seguintes campos ao definir as configurações do webhook:

Propriedade
Descrição
type
WEBHOOK
url
Sua URL do webhook.

Você também pode incluir os seguintes campos:

Propriedade
Descrição
secret

Um campo opcional para o segredo do webhook.

Depois de criar uma notificação de webhook, o URL é parcialmente redigido quando você visualiza ou edita o alerta, e o segredo é totalmente redigido.

Equipes da Microsoft

Você deve fornecer os seguintes campo ao configurar uma integração do Microsoft equipe:

Propriedade
Descrição
type
MICROSOFT_TEAMS
microsoftTeamsWebhookUrl

A URL do webhook de entrada do Microsoft equipe.

Quando você exibe ou edita o alerta de uma notificação de webhook, o URL aparece parcialmente redigido, e o segredo aparece completamente redigido.

Prometeu(a)

Você deve fornecer os seguintes campos ao configurar uma integração Prometheus:

Propriedade
Descrição
type
PROMETHEUS
username
Seu nome de usuário Prometheus.
password
Sua senha Prometheus.
listenAddress
O endereço IP e a porta que sua instância Prometheus alcançará.
serviceDiscovery
Indica qual método de descoberta de serviço é usado, file ou http.
scheme
Seu esquema de protocolo Prometheus configurado para solicitações, http ou https. Se você configurar o https, deverá especificar o tlsPemPath.
enabled
Se o seu cluster tem o Prometheus habilitado.

Você também pode incluir os seguintes campos:

Propriedade
Descrição
tlsPemPassword
Um campo opcional para a senha do seu arquivo PEM.
tlsPemPath
Um campo opcional para o caminho absoluto para seu arquivo PEM.

A resposta inclui uma matriz results que lista todas as configurações de integração de terceiros para o projeto como objetos e um totalCount dos serviços integrados ao projeto.

Cada objeto de configuração de integração de terceiros inclui uma propriedade type igual ao seu próprio tipo de integração ("type": "PAGER_DUTY" para o serviço PagerDuty). Além disso, cada objeto de configuração de serviço de terceiros fornece detalhes específicos para esse serviço. A seguir, listamos as propriedades retornadas para cada objeto de configuração de serviço de terceiros:

Serviço, serviço
Resultado
PagerDuty

Um objeto de configuração de integração PagerDuty retornado contém os seguintes campos:

Propriedade
Descrição
type
PAGER_DUTY
serviceKey

Sua chave de serviço.

Depois de criar uma integração de terceiros que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:

  • Visualize ou edite o alerta por meio da UI.

  • Consulte as configurações de integração de terceiros por meio da API.

Slack

Um objeto de configuração de integração do Slack retornado contém os seguintes campos:

Propriedade
Descrição
type
SLACK
apiToken

Seu token de API.

Depois de criar uma integração de terceiros que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:

  • Visualize ou edite o alerta por meio da UI.

  • Consulte as configurações de integração de terceiros por meio da API.

teamName
Nome da sua equipe. Este campo pode não estar presente com uma integração legada do Slack.
channelName
O nome do canal Slack configurado. Uma string vazia se o valor não estiver definido.
Datadog

Um objeto de configuração de integração do Datadog retornado contém os seguintes campos:

Propriedade
Descrição
type
DATADOG
apiKey

Sua chave de API.

Depois de criar uma integração de terceiros que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:

  • Visualize ou edite o alerta por meio da UI.

  • Consulte as configurações de integração de terceiros por meio da API.

HipChat

Um objeto de configuração de integração do HipChat retornado contém os seguintes campos:

Propriedade
Descrição
type
HIP_CHAT
notificationToken

Token de notificação para sua conta de usuário do HipChat.

Depois de criar uma integração de terceiros que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:

  • Visualize ou edite o alerta por meio da UI.

  • Consulte as configurações de integração de terceiros por meio da API.

roomName
O nome da sua divisão no HipChat.
Opsgenie

Um objeto de configuração de integração Opsgenie retornado contém os seguintes campos:

Propriedade
Descrição
type
OPS_GENIE
apiKey

Sua chave de API.

Depois de criar uma integração de terceiros que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:

  • Visualize ou edite o alerta por meio da UI.

  • Consulte as configurações de integração de terceiros por meio da API.

region
Indica qual URL de API usar,US ou EU. O padrão do Opsgenie é US.

Para definir region como EU, você deve definir uma configuração de cliente de opsgenie.api.url.

VictorOps

Um objeto de configuração de integração do VictorOps retornado contém os seguintes campos:

Propriedade
Descrição
type
VICTOR_OPS
apiKey

Sua chave de API.

Depois de criar uma integração de terceiros que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:

  • Visualize ou edite o alerta por meio da UI.

  • Consulte as configurações de integração de terceiros por meio da API.

O objeto de configuração também pode conter os seguintes campos, dependendo da sua configuração:

Propriedade
Descrição
routingKey
Um campo opcional retornado se você tiver uma Chave de Roteamento configurada.
Configurações do webhook

Um objeto de configuração do webhook retornado contém os seguintes campos:

Propriedade
Descrição
type
WEBHOOK
url

Sua URL do webhook.

Depois de criar uma notificação de webhook, o URL é parcialmente redigido quando você visualiza ou edita o alerta, e o segredo é totalmente redigido.

O objeto de configuração também pode conter os seguintes campos, dependendo da sua configuração:

Propriedade
Descrição
secret
Um campo opcional retornado se o webhook estiver configurado com um segredo.
Equipes da Microsoft

Um objeto de configuração do Microsoft equipe retornado conterá os seguintes campo:

Propriedade
Descrição
type
MICROSOFT_TEAMS
microsoftTeamsWebhookUrl

A URL do webhook de entrada do Microsoft equipe.

Quando você exibe ou edita o alerta de uma notificação de webhook, o URL aparece parcialmente redigido, e o segredo aparece completamente redigido.

Prometeu(a)

Um objeto de configuração Prometheus retornado conterá os seguintes campos:

Propriedade
Descrição
type
PROMETHEUS
username
Seu nome de usuário Prometheus.
listenAddress
O endereço IP e a porta que sua instância Prometheus alcançará.
serviceDiscovery
Indica qual método de descoberta de serviço é usado, file ou http.
scheme
Seu esquema de protocolo Prometheus configurado para solicitações, http ou https. Se você configurar o https, deverá especificar o tlsPemPath.
enabled
Se o seu cluster tem o Prometheus habilitado.

O objeto de configuração também pode conter os seguintes campos, dependendo da sua configuração:

Propriedade
Descrição
tlsPemPassword
Um campo opcional retornado se você tiver uma senha para seu arquivo PEM.
tlsPemPath
Um campo opcional retornado se você tiver um caminho absoluto para seu arquivo PEM.
1curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
2 --header "Accept: application/json" \
3 --header "Content-Type: application/json" \
4 --include \
5 --request POST "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/integrations/SLACK" \
6 --data '
7 {
8 "type": "SLACK",
9 "apiToken": "1234567890",
10 "teamName": "My Team"
1{
2 "links": [
3 {
4 "href": "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/integrations/SLACK?pageNum=1&itemsPerPage=100",
5 "rel": "self"
6 }
7 ],
8 "results": [
9 {
10 "serviceKey": "******7890",
11 "type": "PAGER_DUTY"
12 },
13 {
14 "apiToken": "******7890",
15 "channelName": "My Channel",
16 "teamName": "My Team",
17 "type": "SLACK"
18 }
19 ],
20 "totalCount": 2
21}

Voltar

Obtenha a configuração de uma integração de serviços de terceiros