Objetivo
Apresentar o método de envio de resultados de checagens através da API do OpMon.
Público-alvo
Administradores e usuários da Solução OpMon que desejam enviar resultados de checagens através da API do OpMon.
Pré-Requisito
- OpMon na versão 9.6 ou superior (https://kb.opservices.com.br/knowledge-base/changelog-opmon-9-6/)
- Credencial utilizada no POST deve possuir acesso ao objeto para o qual deseja enviar a checagem.
Exemplo de Uso
curl https://localhost/opmon/seagull/www/index.php/wsconnector/action/sendcheck --insecure --user "opmonadmin:opservices" -H 'Content-Type: application/x-www-form-urlencoded' -X POST -d 'jsonData={"host_name": "opfw", "service_description": "Host-Alive", "plugin_output": "SERVIDOR APRESENTOU FALHA NO ICMP", "state": 1, "perfdata": "rta=0ms;200.000;500.000;0; rtmax=0ms;;;; rtmin=0ms;;;; pl=100%;40;80;0;100"}'
Entendendo os dados enviados:
curl https://localhost/opmon/seagull/www/index.php/wsconnector/action/sendcheck
– URL (endpoint) da API do OpMon
–user “opmonadmin:opservices”
– usuário e senha para conexão ao OpMon (Credencial utilizada no POST deve possuir acesso ao objeto para o qual deseja enviar a checagem)
-H ‘Content-Type: application/x-www-form-urlencoded’
– headers da requisição
-X POST
– método utilizado na requisição
Envio dos dados (detalhamento)
-d ‘jsonData=
– tipo de dado, deve ser enviado como jsonData
{“host_name”: “OPMON”,
– nome do host no OpMon
“service_description”: “Process_crond”,
– nome do serviço no OpMon
“plugin_output”: “SERVIDOR APRESENTOU FALHA NO ICMP”,
– saída textual da checagem, que será exibida nos detalhes da checagem do OpMon
“state”: 1,
– Estado que será assumido pelo OpMon
– Para OK, o valor digitado deve ser 0 (zero), para WARNING deve ser digitado 1 (um) e para CRITICAL deve ser digitado 2 (dois)
“perfdata”: “rta=0ms;200.000;500.000;0; rtmax=0ms;;;; rtmin=0ms;;;; pl=100%;40;80;0;100”}’
– dados de performance que o OpMon irá atribuir para a checagem recebida.
Resultado Esperado (return)
{“success“:true,”message”:”Passive check processed”}