Stream Connect alerta

  • Versão de lançamento: Yokohama
  • Atualizado 15 de nov. de 2024
  • 6 min. de leitura
  • Receba alertas e notificações de alerta para integrações Stream Connect.

    Stream Connect usa o monitoramento ativo e programado para detectar eventos em vários componentes Stream Connect. Se um problema for detectado, o sistema criará um alerta, registrará uma mensagem no log Stream Connect e enviará uma notificação de alerta.

    Alertas

    Stream Connect usa alertas de tipo de evento e alertas de limite. Cada tipo de alerta tem um conjunto de propriedades de alerta que especificam como lidar com o alerta.
    • Alertas de tipo de evento (ou alertas em tempo real) são criados quando há um erro em um componente Stream Connect. Por exemplo, quando um produtor não consegue gravar em um tópico ou um consumidor não consegue ler em um tópico. Esses alertas são integrados ao código e usam as propriedades de alerta para determinar o nível de gravidade e quando uma notificação deve ser enviada. Os alertas do tipo de evento são detectados por meio do monitoramento ativo, que usa vários mecanismos para detectar eventos em vários componentes Stream Connect. O sistema armazena em cache a configuração e detecta os eventos quando eles ocorrem.

    • Os alertas de limite são criados quando um valor faz a transição de abaixo do limite para igual ou superior ao limite. Por exemplo, quando o atraso em um tópico ultrapassa um determinado número de mensagens ou o tempo de processamento das mensagens em um tópico está acima de um valor especificado. Quando um alerta de limite diminui de um limite igual ou superior a ele para abaixo dele, o sinalizador ativo no alerta é definido como falso. Os alertas de limite são detectados por meio do monitoramento programado, em que um trabalho agendado executa verificações com script em Stream Connect integrações. Um alerta é gerado para limites que atendem à configuração de alerta especificada pelas propriedades de alerta.

    Para obter uma lista e a descrição dos alertas ou para configurar as propriedades de alerta, consulte Stream Connect Propriedades de alerta. Você deve ter a função de administrador do Kafka para exibir ou modificar as propriedades de alerta.

    Tabela de alerta

    Quando um alerta é acionado pela primeira vez, um registro de Alerta [sys_sc_alert] é adicionado à tabela Stream Connect Alertas [sys_sc_alerts]. Se o mesmo alerta for acionado novamente e o registro do alerta original ainda estiver ativo, o campo Últimas detecções [last_detection] do registro será atualizado. Se o registro de alerta original não estiver ativo, um novo registro será adicionado à tabela de alertas. Um registro de alerta é desativado quando o alerta não é acionado por um período de tempo especificado. Esse intervalo de tempo varia de acordo com o tipo de alerta e pode ser modificado na IU Stream Connect Propriedades de alerta.

    A tabela Stream Connect alertas mostra se um alerta está ativo e o nível de gravidade, o tipo e a data de atualização do alerta. Ele também exibe:
    • O Númerode um alerta, que faz referência ao registro do alerta. Cada registro de alerta contém informações detalhadas sobre o alerta, incluindo o nome do componente afetado, o nível de gravidade e o carimbo de data/hora.
    • O ID de destinode um alerta, que faz referência ao destino de um alerta, por exemplo, um fluxo Kafka ou um gatilho de fluxo Kafka.
    Você pode exibir a tabela Stream Connect Alertas navegando até Hub de integração > Conexão de fluxo > Alertas.

    Os alertas ficam disponíveis por 30 dias. Um trabalho de limpeza de tabela lida com o período de retenção da tabela de alertas Stream Connect. Os alertas ativos serão desativados se não ocorrerem novamente dentro de uma duração especificada. A duração é configurada por tipo de alerta nas Stream Connect propriedades de alerta.

    Logs de alerta

    As mensagens de log para Stream Connect alertas são gravadas no Stream Connect Log [sys_consumer_log]. Este log tem um campo Alerta [sc_alert] que faz referência ao registro de Alerta Stream Connect associado.

    Os logs ficam disponíveis por 30 dias. O período de retenção de log é determinado pela programação de rotação da tabela para o Log Stream Connect.

    Notificações

    Receba notificações de alerta por e-mail, SMS ou pelo aplicativo para celular ServiceNow®. As notificações contêm informações detalhadas do alerta, incluindo o número do alerta, o nível e uma descrição.

    Quando um alerta é acionado, uma notificação também é acionada, a menos que uma notificação para esse mesmo alerta tenha sido acionada recentemente. Cada alerta tem uma propriedade de intervalo de tempo que especifica a quantidade de tempo, em segundos, necessária entre as detecções de alerta para que as detecções sejam contadas como dois alertas separados. Uma notificação só será acionada se o tempo desde a última notificação for maior que esse intervalo de tempo ou, no caso de alertas baseados em limite, se a severidade do alerta tiver aumentado desde a última detecção. Isso ajuda a garantir que você não receba várias notificações rápidas para o mesmo alerta. A propriedade de intervalo de tempo para cada alerta pode ser modificada na IU Stream Connect Propriedades de alerta.

    Os administradores podem definir as configurações de notificação com base nos tipos de alerta, nas preferências do usuário e nos níveis de severidade do alerta. Existem três níveis de severidade de alerta na tabela Notificações [sysevent_email_action].
    • Alerta de conexão de fluxo - INFO
    • Alerta de conexão de fluxo - AVISO
    • Alerta de conexão de fluxo - CRÍTICO
    Você pode aceitar diferentes níveis usando os recursos de notificação do sistema padrão na plataforma. Os administradores também podem definir configurações de depuração de notificação, incluindo o intervalo de tempo e os critérios para consolidar alertas. Para obter detalhes da notificação, consulte Notifications.

    As notificações são enviadas para usuários que são membros do grupo Stream Connect de Notificações de alerta. Os membros do grupo Stream Connect Notificações de alerta herdam a função Stream Connect de Visualizador de alertas para que todos que recebam notificações possam usar o link na notificação para ver o registro do alerta.

    Funções

    Para exibir Stream Connect Alertas, você deve ter a função de Administrador do Kafka ou a função Stream Connect de Visualizador de Alertas.
    • A função de administrador do Kafka [kafka_admin] pode exibir Stream Connect registros e logs de alerta, configurar Stream Connect propriedades de alerta e definir configurações de notificação de alerta.
    • A função Stream Connect Visualizador de alertas [stream_connect_alert_viewer] tem acesso somente leitura a Stream Connect registros e logs de alertas.

    ACLs e Domain Separation

    As ACLs na tabela Stream Connect Alertas permitem que um usuário com a função Stream Connect de Visualizador de Alertas exiba a tabela de alertas e os relatórios nessa tabela. Usuários sem essa função não podem ler ou relatar nessa tabela. Somente usuários com a função de administrador do Kafka podem inserir e atualizar registros nessa tabela. As ACLs disponibilizam a Stream Connect página de propriedades de alerta somente para administradores do Kafka.

    Em uma instância separada por domínio, as propriedades que controlam os alertas podem ser substituídas por domínio. Consulte Domain separation application properties para obter detalhes.

    O domínio usado para pesquisar propriedades é o domínio do tópico ou consumidor. A IU de propriedades de alerta Stream Connect para definir propriedades define as propriedades globais, não as substituições específicas do domínio. Não há IU para definir substituições específicas de domínio. O sys_domain da tabela Stream Connect Alerts deve ser o mesmo que o domínio do consumidor que o acionou, para alertas do consumidor, ou o domínio do registro sys_kafka_topic para alertas do produtor. Para alertas em que um consumidor ou tópico não é conhecido, o domínio sys_sc_alert é definido como global.

    Plug-in

    O alertaStream Connect requer o plug-in ServiceNow Stream Connect Alerting [com.glide.hub.stream_connect.alerting]. Este plug-in é ativado automaticamente quando o plug-in ServiceNow Stream Connect Installer[com.glide.hub.stream_connect.installer] é ativado.