--- sourceDocument: Xanadu IT Operations Management sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/it-operations-management Release : - xanadu ft:locale : - pt-BR ft:publication_title : - Xanadu IT Operations Management ft:clusterId : - itom bundleId : - itom workflow : - Technology --- # Envio por push de eventos para MID Server usando a API de serviço web # Envio por push de eventos para MID Server usando a API de serviço web {#ariaid-title1} * Versão de lançamento: Xanadu * * Atualizado 1 de ago. de 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura Configure o coletor de eventos do MID WebService para fornecer um método de URL para enviar mensagens de evento para o MID Server. O coletor de eventos do MID WebService, por padrão, permite que você se conecte a um gerador de eventos e envie mensagens de eventos por meio de MID Server, usando um URL no formato: `http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em /jsonv2` O formato JSON v2 é o mesmo que os clientes usam para enviar mensagens de evento para a instância. Este URL oferece bom desempenho. Para obter mais informações, consulte [Configurar o Contexto do coletor de eventos de MID Web Server](https://servicenow-prod.fluidtopics.net/CB_4Vs~aBPhmn3OK7~0pCQ "Configure o Contexto do coletor de eventos do MID WebService para fornecer um método de URL para enviar mensagens de evento de uma origem externa para o MID Server."). Nota: Gestão de eventos aceita eventos no fuso horário de MID Server por meio do qual o ouvinte enviou a mensagem de evento. Se você precisar de um fuso horário diferente, poderá configurar o script conforme necessário, consulte [Integrar com conectores push](https://servicenow-prod.fluidtopics.net/qPFZbex2d3fMNwcrp_2yUw "Integre com um conector push para se conectar a uma origem de evento externo. Os conectores push processam as mensagens de evento coletadas e as transformam no formato de evento necessário."). ## URL para enviar cargas personalizadas O MID Server também pode receber uma carga personalizada nos formatos JSON, XML ou texto simples. Nesse caso, o MID Server transforma as mensagens de evento usando a inclusão de script que você fornece e, em seguida, envia os eventos para a instância. A URL, neste caso, é: `http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/inbound_event?Transform={Transform_script_name}` Para obter um exemplo de uma inclusão de script, consulte a inclusão de script padrão `TransformEvents_xmlSample`. Para obter um exemplo de como o Coletor de eventos do MID WebService transforma mensagens de evento no formato JSON, consulte . Para enviar eventos no formato JSON genérico, você pode usar o URL neste formato: `http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/inbound_event?Transform=TransformEvents_MidJsonGeneric` Nesse caso, a inclusão de script MID `TransformEvents_MidJsonGeneric` fornecida na instância base transforma as mensagens de evento nos campos de evento. Todos os campos são adicionados como campos de informações adicionais ao evento da ServiceNow gerado. Nota: O URL no formato `http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/{transform_script_name}`também é compatível. A URL da REST API para validar a conectividade é: `http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/ping` ## Inclusão de script para transformar eventos coletados Use a inclusão de script MID Server necessária para transformar (analisar) as mensagens de evento coletadas e preenchê-las no campo de evento mapeado. O nome da inclusão de script MID Server é composto por um prefixo e um sufixo. O prefixo é o texto obrigatório `TransformEvents_` e o sufixo é o nome da transformação no URL, por exemplo, `http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/xmlSample ` . O nome do script composto é, portanto, `TransformEvents_xmlSample`. Você deve fornecer uma inclusão de script que receba as mensagens de evento em uma variável de texto. O script deve ter uma função `transform()` que executa a transformação e prepara a matriz de retorno de objetos de evento. Quando o plug-in Gestão de eventos é ativado, você recebe o script de inclusão de amostra `TransformEvents_xmlSample` que transforma eventos do formato XML. Nota: Os campos de evento que não são idênticos aos campos na tabela de eventos são salvos no campo Informações adicionais. ## Cabeçalhos de mensagem de evento Especifique o valor do cabeçalho da solicitação relevante para o campo Tipo de conteúdo de acordo com o formato da mensagem do evento. {#event-collection-via-MID-using-push__table_uqf_ldy_dy__entry__2} | Formato da mensagem | Valor do tipo de conteúdo | |-|-| | JSON | aplicação/json | | XML | aplicação/xml | | texto | texto/simples | [Tabela 1. Solicitar valores de cabeçalho para o tipo de conteúdo] {#event-collection-via-MID-using-push__table_uqf_ldy_dy} ## Opções de autenticação e segurança de dados Opções para autenticação e segurança de dados: * Tipo de autenticação, que pode ser definido como Chave de API ou Básica. * Conexão segura, que permite escolher se os dados de entrada e saída são protegidos quando transmitidos. Se você escolher a opção avançada protegida, será necessário obter um certificado de uma autoridade de certificação conhecida e fornecer o alias do certificado do armazenamento de chaves e a senhado armazenamento de chaves. * Use o MID Unified Keystore, que fornece proteção de criptografia e permite que você instale um certificado personalizado no MID Server armazenamento de chaves unificado. Para obter detalhes, consulte [Instalação de certificados personalizados no armazenamento de chaves unificado do MID Server](https://www.servicenow.com/docs/access?context=mid-unified-keystore&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US). * Os usuários devem fornecer um script que receba as mensagens de evento no formato JSON, XML ou texto em uma variável de texto. O script deve ter uma função transform() que executa a transformação e prepara a matriz de retorno de objetos de evento. O script de inclusão `TransformEvents_xmlSample` que transforma eventos do formato XML é fornecido como um exemplo quando o plug-in Gestão de eventos está ativado. {#event-collection-via-MID-using-push__ul_pz5_cgt_2x}Para obter mais informações sobre autenticação e segurança de dados, consulte [Configurar a extensão MID Web Server](https://servicenow-prod.fluidtopics.net/dZDtcVz4YqdUm3EplawIiw "O MID Web Server é uma MID Server extensão que permite o desenvolvimento de REST APIs para enviar eventos e métricas para o MID Server. A extensão é aproveitada por outras extensões MID Server, como Inteligência para métricas, Ouvinte de eventos do MID WebService e a extensão de endpoint Agent Client Collector do websocket."). **Tarefas relacionadas** * [Como enviar eventos para a instância usando a API de serviço web](https://servicenow-prod.fluidtopics.net/YVCJorh93Ks3VA~JzYY7~Q "Você pode usar uma interface de serviço web, compatível com ServiceNow, que opera no objeto JSON como o formato de entrada e saída de dados.")