Como configurar o servidor de alarmes em um NVR VIGI

Sumário

Introdução

Requisitos

Configuração

Verificação

Cenário 1. Sem imagem anexada

Cenário 2. Com imagem anexada

Valores de Tipo de Evento e Subtipo de Evento

Conclusão

QA

Introdução

O recurso Servidor de Alarmes foi projetado para receber proativamente mensagens de eventos relatadas pelos NVRs da VIGI quando eventos de alarme são acionados.

As informações incluídas no relatório serão gradualmente enriquecidas à medida que a versão do software do dispositivo for atualizada, incluindo tipo de evento, registro de data e hora do evento, detalhes do dispositivo e uma imagem opcional do evento.

Este recurso permite a integração perfeita de alarmes e o processamento de dados entre os NVRs da VIGI e sistemas de terceiros.

Além de explicar como configurar o recurso Servidor de Alarmes em um NVR VIGI, este artigo fornece diretrizes de solução de problemas para possíveis problemas, como falhas de conexão com o servidor, relatórios de eventos anormais e erros de análise do lado do servidor.

Requisitos

• NVR VIGI (com suporte para servidor de alarme)
• Servidor de alarmes
• Laptop

Configuração

Passo 1. Construa a topologia de acordo com o diagrama de topologia abaixo.

Observação: a topologia mostrada neste artigo é apenas para fins de referência. Os cenários de implantação reais são mais diversos.

Passo 2.Faça login na interface web do NVR VIGI com o endereço IP. Digite o Nome de usuário e a Senha e clique em Entrar.

Passo3. Navegue até Configurações > Evento > Servidor de Alarmes, clique no botão “+Adicionar&rdquo.

Passo4. Na janela pop-up, insira as informações relacionadas ao servidor de terceiros. Neste artigo, https://webhook.site/#!/ é usado como servidor de referência.

Etapa 5. Insira o IP do host ou Domínio e a URL do servidor de terceiros, selecione o protocolo apropriado (HTTP ou HTTPS) e especifique o número da porta correspondente, de 1 a 65535. Neste artigo, o protocolo HTTP e a porta 80 são usados para a demonstração da configuração. Você também pode optar por incluir uma imagem anexada na mensagem de evento relatada. Por fim, clique em Salvar para aplicar e armazenar a configuração.

Nota:
1. Nos parâmetros de configuração, o IP/Domínio do Host refere-se ao endereço IP ou nome de domínio do servidor, que neste artigo é webhook.site.

2. A URL corresponde ao caminho da URL usado nas mensagens HTTP trocadas entre o dispositivo e o servidor. Neste documento, a URL padrão do servidor (/0126c2b0-f1cb-4b17-92f8-f64bff5a050f) é usada.

3.O Serviço de Mensagens de Alarme Aprimorado é compatível com NVRs após atualizações de firmware. Depois que essa função é ativada, o Servidor de Alarmes pode incluir informações de alarme mais detalhadas nas mensagens de alarme relatadas, como campos aprimorados relacionados a eventos ou atributos de evento adicionais. Isso ajuda plataformas de terceiros a obter informações de alarme mais ricas para processamento posterior.

Observe que, após ativar esta função, o formato da mensagem de alarme pode ser diferente do formato anterior. Portanto, se o seu servidor de terceiros já implementou a lógica de análise de mensagens de alarme, talvez seja necessário ajustar as regras de análise correspondentes.

Para obter informações sobre as diferenças no formato da mensagem de alarme antes e depois de ativar esta opção, consulte a segunda seção de perguntas e respostas Perguntas e Respostas.

Etapa 6. Você pode clicar no botão “Testar” para verificar o status da conexão entre o dispositivo e o servidor.

Etapa 7. Quando uma mensagem pop-up exibir "O serviço está disponível", isso indica que o status da conexão está normal e a função está operando corretamente. Clique em OK para prosseguir.

Passo 8.Navegue até Configurações > Evento> Evento Inteligente > Detecção Humana, selecione o canal desejado e ative a função de detecção humana.

Nota: Este artigo utiliza a Detecção Humana como exemplo para fins de demonstração. Outras funções de detecção de eventos também funcionarão da mesma maneira.

Passo 9. Verifique as configurações de Desativação.

Navegue até Configurações &> Evento &> Desarmar e verifique as seguintes configurações:

• Se o Modo estiver definido como Armado, nenhuma outra alteração será necessária.
• Se o Modo estiver definido como Desarmar, certifique-se de que Enviar para o Servidor de Alarmes não esteja selecionado em Ação de Vinculação de Alarme de Desarmar. Qualquer ação selecionada nesta seção será desativada enquanto o NVR estiver desarmado.

Clique em Aplicar para salvar as configurações.

Nota:A opção "Enviar para o Servidor de Alarmes" na página de Desativação está disponível apenas em determinados modelos com versões de firmware compatíveis.Por padrão, o Modo está definido como Armado. Se a opção "Enviar para o Servidor de Alarmes" não estiver disponível, o NVR enviará todos os eventos para o Servidor de Alarmes por padrão.

Verificação

Etapa 1.Configure o espelhamento de portas no switch para espelhar a porta conectada ao NVR VIGI na porta conectada ao laptop. Inicie a captura de pacotes na interface de rede do laptop usando o Wireshark e, em seguida, acione o evento de Detecção Humana.

Etapa 2. Verifique as informações relatadas pelo NVR VIGI.

Cenário 1. Sem imagem anexada

Passo 1. Digite "http" na barra de filtros do Wireshark para exibir os pacotes HTTP capturados. Em seguida, verifique a Solicitação HTTP POST e a Resposta HTTP.

Etapa 2. Verifique os Cabeçalhos da Requisição HTTP POST

Observação: A primeira linha contém o método POST, o URI de destino da solicitação e a versão HTTP 1.1. O URI corresponde à string de URL configurada anteriormente nas configurações do Servidor de Alarmes.

Da segunda linha até a linha em branco, cada linha representa um par chave-valor que descreve os metadados da solicitação. Estes incluem Host, Content-Type, Content-Length e Cache-Control.

Quando o Content-Type é definido como application/json, isso indica que apenas a mensagem do evento é enviada (sem umaimagem anexada) e o corpo da solicitação é uma string formatada em JSON.

Cada linha termina com \r\n. Uma linha em branco contendo apenas \r\n indica o fim dos cabeçalhos da requisição e o início do corpo da requisição.

Etapa 3. Verifique o Corpo da Requisição HTTP POST

Nota:No payload JSON, device_id representa o ID exclusivo do NVR que reportou o evento, e device_name especifica o nome do NVR que reportou o evento. O campo messages é uma matriz contendo os eventos reportados. Dentro de messages, Event Type indica o tipo de evento disparado, Event Sub Type indica o subtipo do evento disparado, EVENT TIME indica quando o evento ocorreu, Camera indica o canal que disparou o evento, Camera Name especifica o nome do canal disparado e Extra Text é reservado para informações adicionais.

Etapa 4.Verifique a Resposta HTTP. Um código de status 200 OK retornado indica que o servidor webhook.site recebeu e processou a solicitação com sucesso.

Etapa 5. Compare os dados relatados no corpo da solicitação HTTP POST com os dados recebidos e analisados pelo servidor webhook.site para verificar se são consistentes.

Cenário 2. Com imagem anexada

Etapa 1. Antes de iniciar a captura de pacotes, clique no botão Editar no canto superior direito da página do servidor webhook.site e modifique o Content-Type para mensagens com imagens anexadas para multipart/form-data; boundary=ReportEventBoundary.

Observação: multipart/form-data permite que várias partes de dados, como informações de eventos JSON e um instantâneo JPEG, sejam incluídas na mesma solicitação HTTP body.boundary = ReportEventBoundary especifica o limite usado para separar diferentes partes da carga útil de dados.

Etapa 2. Use o comando “http” para filtrar os pacotes capturados. Em seguida, verifique os cabeçalhos e corpo da solicitação HTTP POST.

Nota: O corpo da requisição começa após uma linha em branco (\r\n). Como o Content-Type é multipart/form-data, o corpo é dividido em várias partes, cada uma separada pelo delimitador --ReportEventBoundary. O corpo da requisição termina com --ReportEventBoundary--.

A primeira parte tem o nome "evento" e contém os dados JSON do evento. A segunda parte usa o nome "snapshot" e contém os dados JPEG do snapshot. Para cada parte, o Content-Type especifica o formato dos dados, enquanto o Content-Length especifica o tamanho do conteúdo correspondente em bytes.

Os dados JPEG exibidos no Wireshark representam o conteúdo binário da imagem capturada.

Etapa 3.Verifique a Resposta HTTP. Um código de status 200 OK retornado indica que o servidor webhook.site recebeu e aceitou a solicitação com sucesso.

Etapa 4. Compare os dados relatados no corpo da solicitação HTTP POST com os dados recebidos e analisados pelo servidor webhook.site para verificar se são consistentes.

Observação: o servidor webhook.site em si não analisa nem decodifica o conteúdo da imagem enviada. Ele apenas recebe e exibe os dados da solicitação HTTP. Portanto, somente as informações do evento e o carimbo de data/hora da imagem correspondente são visíveis.

Valores de Tipo de Evento e Subtipo de Evento

Os campos Tipo de Evento e Subtipo de Evento utilizam valores numéricos para identificar a categoria e o tipo específico de cada evento relatado. Consulte as tabelas a seguir para obter os valores suportados.

Nota:

1. Os campos incluídos em uma mensagem do Servidor de Alarmes variam dependendo do evento relatado. Todas as mensagens incluem o tipo de evento, o subtipo de evento e a hora do evento. Somente as notificações com Tipo de Evento 1 incluem o número do canal acionado e o nome do canal. Após a ativação do Serviço de Mensagens de Alarme Aprimorado, esses campos são exibidos como Tipo de Evento, Subtipo de Evento, HORA DO EVENTO, Câmera e Nome da Câmera, em vez dos nomes de campo originais.tipo, subtipo, hora local, canal e nome do canal.
2. Certos eventos de exceção do dispositivo incluem um valor adicional que identifica o componente que acionou o evento. O significado desse valor depende do Tipo de Evento e do Subtipo de Evento relatados, conforme mostrado abaixo.

3. Os seguintes eventos relacionados a RAID estão disponíveis apenas em modelos de NVR que suportam RAID: Falha no Array RAID, Degradação do Array RAID, Recuperação do Array RAID usando um Hot Spare, Falha no Hot Spare, Nenhum Array RAID disponível, Array RAID cheio e Erro de senha RAID.
4. Os seguintes eventos relacionados a PoE estão disponíveis apenas em modelos de NVR que suportam PoE: Curto-circuito em uma única porta PoE, Sobrecarga em uma única porta PoE, Erro de temperatura do chip PoE e Sobrecarga total PoE.

Conclusão

Você configurou o recurso Servidor de Alarmes. Quando um evento configurado é acionado, o NVR VIGI reporta as informações do evento e, se habilitado, o snapshot correspondente ao Servidor de Alarmes.

QA

P1: Se o Servidor de Alarmes foi configurado com sucesso, mas nenhum dado de alarme é recebido pelo servidor quando um evento é acionado, o que devo fazer?

A1: Por favor, realize as seguintes verificações:

Etapa 1.Realize uma verificação de configuração preliminar. Analise os registros do NVR para confirmar se o evento foi detectado e acionado. Os NVRs da VIGI não exigem configurações de relatório do Servidor de Alarme separadas para canais individuais. Para configurações que podem impedir que eventos sejam relatados enquanto o NVR estiver desarmado, consulte a Etapa 9. Verifique as configurações de Desarmamento. Verifique também todos os parâmetros de configuração do Servidor de Alarme. Verifique se o servidor está escutando na porta configurada e se a URL configurada corresponde exatamente ao endpoint do servidor.

Etapa 2. Configure o espelhamento de porta e capture pacotes do lado do dispositivo. Em seguida, verifique os seguintes itens sequencialmente:

• Conexão TCP: Verifique se o handshake TCP de três vias entre o dispositivo e o servidor foi estabelecido com sucesso.
• Solicitação HTTP POST: Confirme se a solicitação POST foi iniciada com sucesso e se o formato do cabeçalho da solicitação está correto. Preste atenção especial ao campo Content-Type. Quando apenas informações de eventos são relatadas, o Content-Type deve ser application/json. Quando uma imagem de captura de tela é incluída, o Content-Type deve ser multipart/form-data, e os dados mistos (string JSON e dados de imagem) devem ser separados usando boundary=ReportEventBoundary.
• Resposta HTTP: Verifique o código de status da resposta HTTP retornado no pacote para confirmar se o servidor respondeu corretamente à solicitação HTTP.

P2: Qual é a diferença no formato da mensagem de alarme antes e depois de ativar o Serviço de Mensagens de Alarme Aprimorado?

A2: Após a ativação do Serviço de Mensagens de Alarme Aprimorado, um campo Texto Extra adicional é incluído na mensagem do Servidor de Alarme. Se o seu servidor de terceiros utiliza lógica de análise baseada no formato anterior, revise-a e atualize-a, se necessário. Veja a comparação abaixo para mais detalhes.

Antes de ativar o Serviço de Mensagens de Alarme Aprimorado:

Após ativar o Serviço de Mensagens de Alarme Aprimorado:

Para saber mais sobre cada função e configuração, visite a Página Inicial de Suporte para baixar ou consultar o manual do seu produto.