Criando um API Token

Para criar um API Token na plataforma:
2 – Na aba API, clique no botão “+” para criar um novo API Token
3 – Selecione o tipo Api Token e preencha o campo Name, em seguida, clique em Generate Integration Token

Criando um External Service Dynatrace

1 – Entre no Service Hub, localizado no menu lateral esquerdo

2 – Selecione entre as opções, caso queira abrir um alerta, selecione Alert Dynatrace ou caso queira abrir um incidente, selecione Incident Dynatrace 

 

3 – No formulário, deve preencher o External service name e os Responders que receberão s notificações deste serviço, em seguida clique em CREATE

4 – Mais abaixo aparecerá as informações do seu External Service solicitando que selecione um Api token, selecione o criado anteriormente

5 – Após selecionar o Api Token, as informações necessárias para configurar o External Service Dynatrace estão completas

 

6 – Após criados, seus External Services aparecerão no External services monitoring center, eles serão classificados em ordem de status (em alarme antes dos operacionais)

 

Configurando no Dynatrace

1. Abra o Dynatrace e, no menu à esquerda, vá em Manage > Settings: 


 

2 – Selecione Integration e, em seguida, Problem Notification: 


 

3. Clique em Add Notification e vamos configurar uma nova notificação.

 

3.1 – Em Notification Type, selecione Custom Integration.

 

3.2 – Dê um nome para a notificação em Display Name.

 

3.3 – Em Webhook URL, coloque a URL obtida na criação do External Service.

 

3.4 – Deixe ativo o Call Webhook if problem is Closed. 


 

3.5 – Adicione uma HTTP Header, passando em Name User-Agent e em Value 1PCustomAuth/1.0.


 

3.6 – No campo Custom Payload, cole o payload fornecido pela equipe da ElvenWorks.

 

Exemplo de Payload:

				
					{  

  "title": "{ProblemTitle}",

  "description": "{ProblemDetailsText}",

  "external_aggregate_key": "{Pid}",

  "action": "{State}",

  "severity": ""

}
				
			

O campo "severity" deverá ser preenchido com os seguintes valores:

  • critical
  • high
  • moderate
  • low
  • informational

3.7 - Selecione o Alerting Profile que você quer que sejam geradas as notificações. 

Após isso é só salvar e pronto, sua integração está feita. Todos os
incidentes gerados no Dynatrace relacionados ao Alerting Profile
configurado irão chegar e notificar também na One Platform.

Criando um API Token

Para criar um API Token na plataforma:
2 – Na aba API, clique no botão “+” para criar um novo API Token
3 – Selecione o tipo Api Token e preencha o campo Name, em seguida, clique em Generate Integration Token

Criando um External Service Sentry

1 – Entre no Service Hub, localizado no menu lateral esquerdo

2 – Selecione entre as opções, caso queira abrir um alerta, selecione Alert Sentry ou caso queira abrir um incidente, selecione Incident Sentry 

3 – No formulário, deve preencher o External service name e os Responders que receberão s notificações deste serviço, em seguida clique em CREATE

4 – Mais abaixo aparecerá as informações do seu External Service solicitando que selecione um Api token, selecione o criado anteriormente

5 – Após selecionar o Api Token, as informações necessárias para configurar o External Service Sentry estão completas

6 – Após criados, seus External Services aparecerão no External services monitoring center, eles serão classificados em ordem de status (em alarme antes dos operacionais)

 

 

Configurando no Sentry

1. Primeiro clique em “Settings” e em seguida em “Integrations”


 

 

2. Busque por “Webhook” na barra de pesquisa

3. Clique em “Add to Project” (Caso tenha mais de 1 projeto, escolha para qual deseja criar a integração)

4. No campo “Callback URLs” insira a URL obtida na criação do External Service Sentry, clique em “Save Changes” e, em seguida, clique em “Enable Plugin”


5. Para testar a integração, você pode clicar em “Test Plugin” (Um incidente deverá ser criado na OnePlatform)


6. Para vincular o webhook a um alerta, entre na configuração das condições e, no campo “THEN”,  selecione “send notification via an integration”, em seguida, escolha a opção “WebHooks”


Pronto! Sua integração com o Sentry já está configurada.

Criando um API Token

Para criar um API Token na plataforma:
1 – Clique em Organization Settings no canto inferior esquerdo
2 – Na aba API, clique no botão “+” para criar um novo API Token
3 – Selecione o tipo Api Token e preencha o campo Name, em seguida, clique em Generate Integration Token

Criando um External Service Datadog

1 – Entre no Service Hub, localizado no menu lateral esquerdo

2 – Selecione entre as opções, caso queira abrir um alerta, selecione Alert Datadog ou caso queira abrir um incidente, selecione Incident Datadog 

3 – No formulário, deve preencher o External service name e os Responders que receberão s notificações deste serviço, em seguida clique em CREATE

4 – Mais abaixo aparecerá as informações do seu External Service solicitando que selecione um Api token, selecione o criado anteriormente

5 – Após selecionar o Api Token, as informações necessárias para configurar o External Service Datadog

6 – Após criados, seus External Services aparecerão no External services monitoring center, eles serão classificados em ordem de status (em alarme antes dos operacionais)

 

Configurando no Datadog

1. Primeiro clique em integrations no menu lateral esquerdo

 

2. Na barra de pesquisa, pesquise por “webhooks”, clique no card que apareceu

 

3. Clique em “New” para adicionar um novo webhook

 

4. Preencha os campos conforme a imagem abaixo e clique em “Save

 

5. Para adicionar o webhook a um monitoramento clique em “Monitors” no menu lateral esquerdo e escolha o monitoramento que deseja ou crie uma

 

6. Na tela de edição do monitoramento, adicione o webhook criado no campo “Notify your team

 

7. Teste a integração clicando em “Test Notifications” no final da tela de edição

 

8. Escolha o tipo de notificação e clique em “Run Test

 

9. Um incidente/alerta deverá ser criado na OnePlatform notificando o time escolhido na hora da solicitação da integração

 

 

Pronto! Sua integração 1P+Datadog está configurada.

Criando um API Token

Para criar um API Token na plataforma:
1 – Clique em Organization Settings no canto inferior esquerdo
2 – Na aba API, clique no botão “+” para criar um novo API Token
3 – Selecione o tipo Api Token e preencha o campo Name, em seguida, clique em Generate Integration Token

 

Criando um External Service New Relic

1 – Entre no Service Hub, localizado no menu lateral esquerdo

2 – Selecione entre as opções, caso queira abrir um alerta, selecione Alert New Relic ou caso queira abrir um incidente, selecione Incident New Relic 

3 – No formulário, deve preencher o External service name e os Responders que receberão s notificações deste serviço, em seguida clique em CREATE

4 – Mais abaixo aparecerá as informações do seu External Service solicitando que selecione um Api token, selecione o criado anteriormente

5 – Após selecionar o Api Token, as informações necessárias para configurar o External Service New Relic estão completas

6 – Após criados, seus External Services aparecerão no External services monitoring center, eles serão classificados em ordem de status (em alarme antes dos operacionais)

 

 

Configurando no New Relic

1 – No NewRelic, no menu à esquerda, vá em Alerts & AI e clique em Alert Conditions & Policies:

 

Criar um novo Alert Policy:


 

Selecionar One Issue per condition and signal 


 

Finalizar clicando em Create policy whithout notifications.

 

2 – No menu à esquerda clique em Workflows e depois no canto superior direito da tela e selecione Add a workflow:

 

3 – De um nome de sua preferência ao workflow e selecione a Policy criada na etapa 1:

 

4 – Em Notify selecione Webhook e depois Add a destination:


 

Coloque o nome de identificação de sua preferência em Webhook name

 

Em Endpoint URL: informar a url disponibilizada ao criar o External Service New Relic


 

Após preencher, clique em Save destination.

 

Preencher com as informações enviadas pelo time da ElvenWorks:

 

Após inserir o payload fornecido pelo time da ElvenWorks clique em Save message

1 – Faça integração com o Servicenow e abra tickets dos seus incidentes de forma rápida e eficaz através da One Platform. Para começar, clique em “Create ITSM Servicenow” no menu esquerdo.


 

2 – Preencha o formulário com as informações fornecidas pelo Servicenow.


 

3 – Após a conclusão do cadastro, no menu “View all integrations”, na lateral esquerda, deverá aparecer sua integração.


 

4 – Pronto! Agora você pode abrir tickets no Servicenow à partir da tela do incidente na One Platform.

Para abrir o ticket no Servicenow clique no botão “OPEN TICKET” na tela do incidente.


 

Após isso, será aberto um ticket no Servicenow referente ao incidente aberto na 1P



 

As alterações que forem feitas na 1P (por exemplo: acknowledge, título, descrição, etc) serão refletidas no ticket do Servicenow.



 

Quando o incidente for resolvido na 1P, isso refletirá no ticket do Servicenow

Com o external service custom, recebemos dados em nossa API (Application Programming Interface). Nós geramos um CURL que nos enviará os dados de “alarmed” (abre um incidente na plataforma) ou “resolved” (fecha o incidente na plataforma). Desta forma, nossa plataforma consegue tratar esses dados e acionar sua equipe caso a sua aplicação esteja com erro. Para configurar uma integração custom, solicite junto à nossa equipe o CURL.

Criando um API Token

Para criar um API Token na plataforma:
1 – Clique em Organization Settings no canto inferior esquerdo
2 – Na aba API, clique no botão “+” para criar um novo API Token

3 – Selecione o tipo Api Token e preencha o campo Name, em seguida, clique em Generate Integration Token

Criando um External Service Custom

1 – Entre no Service Hub, localizado no menu lateral esquerdo

2 – Selecione entre as opções, caso queira abrir um alerta, selecione Alert Custom ou caso queira abrir um incidente, selecione Incident Custom 

3 – No formulário, deve preencher o External service name e os Responders que receberão s notificações deste serviço, em seguida clique em CREATE

4 – Mais abaixo aparecerá as informações do seu External Service solicitando que selecione um Api token, selecione o criado anteriormente

5 – Após selecionar o Api Token, as informações necessárias para configurar o CURL estão completas

6 – Após criados, seus External Services aparecerão no External services monitoring center, eles serão classificados em ordem de status (em alarme antes dos operacionais)



Segue um exemplo de CURL da integração custom:
curl --request POST \
  --url '<URL da API Elven>' \
  --header 'Content-Type: application/json' \
  --header 'User-Agent: 1PcustomAuth/1.0' \
  --data '{
  "title": "<título do incidente>",
  "description": "<descrição do incidente>",
  "external_aggregate_key": "001",
  "action": "alarmed",
  "organization": "<org_uid fornecido pela Elven>",
  "severity": "critical"
}'
 
  • “–url” = API_URL gerada na criação do External Service;
  • “titile” = Neste campo você define um título que aparecerá no incidente aberto na 1P;
  • “description” = Neste campo você define uma descrição ao incidente, aparecerá em “causa” no incidente aberto na 1P;
  • “external_aggregate_key” = Neste campo você define um identificador para “abrir” e “fechar” o incidente, ou seja, quando for fechar o incidente, ele deve ter o mesmo external_aggregate_key que o incidente aberto;
  • “action” = Neste campo você define a ação a ser executada podendo ser “alarmed” (abre o incidente) ou “resolved” (fecha o incidente);
  • “organization” = Este campo é fornecido pela equipe da Elven no momento da solicitação;
  • “severity” = Neste campo você define a severidade associada ao incidente podendo ser informational, low, moderate, high ou critical.

Obs.: não se esqueça de adicionar os headers:

 –header ‘Content-Type: application/json’ \

 –header ‘User-Agent: 1PcustomAuth/1.0’ \

Postando este CURL você abrirá/fechará incidentes na plataforma, podendo assim fazer a gestão, sendo notificado.

Criando um API Token

Para criar um API Token na plataforma:

2 – Na aba API, clique no botão “+” para criar um novo API Token

3 – Selecione o tipo Api Token e preencha o campo Name, em seguida, clique em Generate Integration Token

Criando um External Service Zabbix

1 – Entre no Service Hub, localizado no menu lateral esquerdo

2 – Selecione entre as opções, caso queira abrir um alerta, selecione Alert Zabbix ou caso queira abrir um incidente, selecione Incident Zabbix

3 – No formulário, deve preencher o External service name e os Responders que receberão s notificações deste serviço, em seguida clique em CREATE

4 – Mais abaixo aparecerá as informações do seu External Service solicitando que selecione um Api token, selecione o criado anteriormente

5 – Após selecionar o Api Token, as informações necessárias para configurar o External Service Zabbix estão completas

6 – Após criados, seus External Services aparecerão no External services monitoring center, eles serão classificados em ordem de status (em alarme antes dos operacionais)


Configurando no Zabbix

1 – No Zabbix, no menu à esquerda, vá em Administration e clique em Media types:

 

 

2 – Clique em Import no canto superior direito da tela e selecione o arquivo de configuração da versão do Zabbix:

 

3 – Depois de selecionar o arquivo, marque a opção Create new e clique em Import:

 

4 – Em seguida, volte em Media types e selecione One Platform que foi criado:

 

5 – Configure os campos com os dados que foram passados através da External Integration:

 

Onde está <PLACE YOUR ONE PLATFORM>, alterar para os dados:

one_platform_organization: uID da Organização

one_platform_url: URL da API

 

Após configurar, clicar em Update.


6 – No menu esquerdo, vá em Administration e clique em Users:

 

7 – Selecione o user Admin e vá em Media:

 

8 – Clique em Add e configure a Media:

 

Type: One Platform

Send to: One Platform

8.1 – Clique em Add e, em seguida, clique em Update:

 

Os passos 8 e 8.1 devem ser feitos para todos os usuários configurados que você deseja fazer a liberação do Media type.

9 – No menu esquerdo, vá em Configuration, clique em Actions e em Trigger Actions:

 

 

10 – Na aba Action, dê um nome para a action e, em Conditions, clique em Add:

 

10.1 – Selecione o type de acordo com suas configurações: (ex: Host/Host Group)

 

 

10.2 – Clique em Add.

 

11 – Na aba de Operations, clique em Add:

 

11.1 – Configure a operação desejada para o seu Action trigger:

 

Send to user groups: Grupos de usuários que receberão o alerta

Send to users: Usuários que receberão o alerta

12 – O mesmo procedimento deve ser feito no campo Recovery Operations:

 

 

12.1 – Clique em Add na janela de Operation details e depois novamente em Add para adicionar a Trigger action.

 

13 – Pronto! Seu Zabbix já está integrado com nossa plataforma 1P. Sempre que houver algum problema, será alertado na plataforma na aba de Incidents e, ao ser resolvido, o Incident se dará como Resolved.

Adicionar severidade à integração com Zabbix

Para configurar a severidade do incidente, vá no menu configurações, em “hosts” e clique em “triggers”

Vá na trigger que deseja adicionar a severidade ou crie uma nova e escolha uma das opções disponíveis.

A severidade aparecerá no padrão usado pela OnePlatform:

  • information = informational
  • warning = low
  • average = moderate
  • high = high
  • disaster = critical

Observação:

Todos os passos a seguir deverão ser feitos após a External Integration (Custom) já ter sido configurada pela equipe ElvenWorks e que sejam fornecidos os seguintes dados: URL da API, Cabeçalho (HEADER) e Payload. Solicite a integração através do chat na plataforma ou no site.

 

1 – Na sua Elastic Cloud, vá em Stack Management:



2 – Na parte de Alerts and Insights, clique em Connectors:



3 – Clique em Create Connector e selecione Webhook. Configure-o com os dados que foram gerados pela External Integration:



Connector Name: Nome do Conector que você deseja criar

 

Method: POST

URL: <API_URL gerada na criação da External Integration>

 

Não é necessária a autenticação, podendo ser desmarcada a opção

 

Marcar a opção ADD HTTP HEADER:

Key: User-Agent

Value: 1PcustomAuth/1.0

 

Clicar em Save & Test.


4 – Na próxima tela, colar o payload gerado pela External Integration no BODY:



title: Título do Incident que aparecerá na 1P

description: Descrição do Incident que aparecerá na 1P

external_aggregate_key: Identificador do Incidente (Caso queira ter N Monitoramentos para uma mesma integração)

action: Tipo de ação (Alarmed ou Resolved)

organization: ID da Organização da 1P


Após configurado, clicar em Run.

Pronto, sua integração Elastic Cloud + 1P está criada e chegará uma
notificação de Incident de Teste na Plataforma. Lembrando que essa
configuração do Connector no Elastic Cloud segue as configurações que
estão no seu Alerting Rules.

Criando um API Token

Para criar um API Token na plataforma:

2 – Na aba API, clique no botão “+” para criar um novo API Token

3 – Selecione o tipo Api Token e preencha o campo Name, em seguida, clique em Generate Integration Token

 

Criando um External Service Cloudwatch

1 – Entre no Service Hub, localizado no menu lateral esquerdo

2 – Selecione entre as opções, caso queira abrir um alerta, selecione Alert Cloudwatch ou caso queira abrir um incidente, selecione Incident Cloudwatch 

3 – No formulário, deve preencher o External service name e os Responders que receberão s notificações deste serviço, em seguida clique em CREATE

4 – Mais abaixo aparecerá as informações do seu External Service solicitando que selecione um Api token, selecione o criado anteriormente

5 – Após selecionar o Api Token, as informações necessárias para configurar o External Service Cloudwatch estão completas

6 – Após criados, seus External Services aparecerão no External services monitoring center

 

Configurando no Cloudwatch

1 – Na aws devemos criar uma lambda, no menu de serviços por lambda, depois Create Function:

Na criação da lambda, devemos informar o nome e o Runtime. Por padrão o utilizado é o Node.js 16x.

 

Após preencher os campos acima clique em CREATE FUNCTION.

2- Após acessar a lambda criada, em code source, substituir o padrão pelo obtido na criação do External Service Cloudwatch

Padrão: 


 

Clique em deploy, após inserir o código fornecido.

 

3- Acessar o serviço SNS:


 

Após acessar o serviço, acesse topics e depois create topic:

Selecionar a opção Standard, de um nome de sua preferência.

 

 

Após isso clicar em Create topic

4 – Ao criar o tópico, o próximo passo é associar a lambda criada. Para isso, role o cursor do mouse até o fim da página e clique em Create Subscription.

 

 

Selecione o tópico criado, em protocolo escolha o AWS Lambda e no endpoint selecione o criado para a integração. Após isso clique em Create subscription.

5 – Após criar o tópico SNS, devemos configurar no Cloudwatch.

 

Ao acessar o serviço cloudwatch, o próximo passo é criar o alerta clicando em “Create alarm”.

Selecione a métrica que seja monitorar, no exemplo abaixo estamos monitorando a métrica de CPU Utilization:

Defina as condições conforme sua operação

Clique em next para a próxima etapa.


6- Configure actions, devemos configurar a notificação para as três status:

  • In Alarm
  • OK
  • Insufficient data

Todos devem enviar para o tópico criado no SNS, conforme exemplo:

Clique em next para a próxima etapa e assim nomear o alerta criado

Verifique se o alerta e condições foram criadas corretamente e clique em Create alarm para finalizar. Após isso todos os alertas do Cloudwatch deverão aparecer no One Platform.

Criando um API Token

Para criar um API Token na plataforma:
1 – Clique em Organization Settings no canto inferior esquerdo
2 – Na aba API, clique no botão “+” para criar um novo API Token
3 – Selecione o tipo Api Token e preencha o campo Name, em seguida, clique em Generate Integration Token

Criando um External Service Grafana

1 – Entre no Service Hub, localizado no menu lateral esquerdo

2 – Selecione entre as opções, caso queira abrir um alerta, selecione Alert Grafana ou caso queira abrir um incidente, selecione Incident Grafana 

3 – No formulário, deve preencher o External service name e os Responders que receberão s notificações deste serviço, em seguida clique em CREATE

4 – Mais abaixo aparecerá as informações do seu External Service solicitando que selecione um Api token, selecione o criado anteriormente

5 – Após selecionar o Api Token, as informações necessárias para configurar o External Service Grafana estão completas

6 – Após criados, seus External Services aparecerão no External services monitoring center, eles serão classificados em ordem de status (em alarme antes dos operacionais)


Configurando no Grafana

1 – No Grafana, no menu à esquerda, vá em contact point e clique em Add contact point;





Name: 1p-Elvenworks

Integration : Selecione “Webhook”

URL: URL disponibilizada na criação do External Service

 

Rolar para cima