Evento - Global

A API de evento fornece métodos que permitem a configuração/obtenção de valores em um evento.

Esses eventos são enviados de uma instância MID Server para ServiceNow. Antes de enviar eventos com êxito, a conexão entre as instâncias MID Server e ServiceNow deve ser definida.

Use a API de eventos para adicionar/atualizar campos em um evento. Use a API SNEventSenderProvider para criar uma instância de um objeto de remetente de evento. Em seguida, use a API IEventSender para enviar o evento para uma instância ServiceNow.

Você deve ativar o plug-in Event Management (com.glideapp.itom.snac) antes de tentar acessar esta API. O plug-in Event Management requer uma assinatura separada e deve ser ativado pela equipe ServiceNow. Este plug-in inclui dados de demonstração e ativa plug-ins relacionados, caso ainda não estejam ativos.

Para obter informações adicionais sobre gerenciamento de eventos, consulte Event Management.

Evento - Evento()

Instancia um construtor de evento.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
Nenhum

var event = new Event();
var esource = event.getField("source");
var eseverity = event.getField("severity");       

Evento - getField(cadeia de caracteres campo)

Retorna o valor atual do passado no campo de gestão de eventos.

Tabela 2. Parâmetros

Nome	Tipo	Descrição
Assunto:	Cadeia de caracteres	Nome do valor do campo de gestão de eventos a retornar.

Tabela 3. Retorna

Tipo	Descrição
Cadeia de caracteres	Valor do campo de gestão de eventos solicitado.

var event = new Event();
var eventSource = event.getField("source");
var eventSeverity = event.getField("severity");       

Evento - setAdditionalInfo(cadeia de caracteres additionalInfo)

Substitui o campo additional_info existente no evento associado pela cadeia de caracteres JSON passada.

Nota:

Você pode usar o método setField() para atualizar um campo específico no campo additional_info.

Tabela 4. Parâmetros

Nome	Tipo	Descrição
additionalInfo	Cadeia de caracteres	Cadeia de caracteres JSON (pares de chave/valor) a ser salva no campo additional_info. Nota: Este parâmetro substitui as informações existentes. Ele não atualiza os campos existentes.

Tabela 5. Retorna

Tipo	Descrição
vazio

event.setAdditionalInfo("{\"evtComponent\":\"Microsoft-Windows- WindowsUpdateClient\",\"evtMessage\":\"Installation Failure: Windows failed. Error 0x80070490\"}");

Evento - setField(cadeia de caracteres chave, cadeia de caracteres valor)

Define o campo especificado no evento associado.

Se o passado em key corresponder a um campo de evento predefinido, o método atualizará o campo de evento correspondente. Caso contrário, o método adiciona o parâmetro [ key à seção additional_info do evento antes de aplicar o passado em value.

A seguir estão os campos de evento predefinidos que você pode modificar usando este método:

Campo	Descrição
adicional_informações	Par chave-valor a ser adicionado ao campo additional_info do evento associado. Se a chave passada já existir, seu valor será substituído. Tamanho máximo: 4.000 caracteres Campo de IU associado: informações adicionais
ci_identifier	Cadeia de caracteres JSON que identifica exclusivamente um item de configuração. Por exemplo, {"name":"SAP ORA01","type":"Oracle"}. Tamanho máximo: 1.000 caracteres
cmdb_ci	Sys_id do registro do item de configuração [cmdb_ci] ao qual vincular o evento. Padrão: nulo
description	Descrição de forma livre do evento. Tamanho máximo: 4.000 caracteres Campo de IU associado: Descrição Padrão: nulo
event_class	Enterprise Message Service (EMS) que gerou o evento. Por exemplo, "SolarWinds" ou "SCOM". Tamanho máximo: 100 Campo de IU associado: instância de origem Padrão: nulo
message_key	Identificador de evento exclusivo. Para substituir uma severidade de evento existente, use o mesmo valor message_key. Tamanho máximo: 1024 caracteres Campo de IU associado: chave de mensagem Padrão: combinação de source, node, type, resourcee metric name.
resolução_estado	Estado de resolução do evento. Valores válidos: Novo: o estado de resolução do evento correspondente está aberto. Encerramento: o estado da resolução do evento correspondente é encerramento/encerrado. Campo de IU associado: estado de resolução Padrão: Novo
recurso	Recurso de nó a ser associado ao evento. Por exemplo, "Disco C:", "CPI-1" ou o nome de um processo ou serviço. Tamanho máximo: 100 caracteres Campo de IU associado: recurso
severidade	Severidade do evento. Valores válidos: 0: Limpar - nenhuma ação é necessária. Um alerta não será criado a partir deste evento. Os alertas existentes são encerrados. 1: Ok - Um alerta é criado. O recurso ainda está funcional. 2: aviso - é necessário atenção, embora o recurso ainda esteja funcional. 3: Secundário - Ocorreu uma perda parcial não crítica de funcionalidade ou degradação do desempenho. 4: Importante - A funcionalidade principal está gravemente prejudicada ou o desempenho foi degradado. 5: Crítico - A ação imediata é necessária. O recurso não está funcional ou há problemas críticos iminentes. Campo de IU associado: gravidade Padrão: nulo
origem	Instância do EMS que acionou o evento. Normalmente, o nome da instância do conector. Tamanho máximo: 200 caracteres Campo de IU associado: origem Padrão: nulo
time_of_event	Hora em UTC em que o evento ocorreu no sistema de origem. Formato: "aaaa-MM-dd HH:mm:ss" Tamanho máximo: 40 caracteres Campo de IU associado: hora do evento Padrão: data/hora atuais
tipo	Tipo de métrica ao qual o evento está relacionado, como Disco ou CPU. Este valor é usado para identificar um registro de evento a partir do qual os alertas são criados. Tamanho máximo: 100 caracteres Campo de IU associado: tipo Padrão: nulo

Nota:

Você também pode usar o método setText() para atualizar o campo description e o método setTimeOfEvent() para atualizar a hora do evento.

Para obter informações adicionais sobre eventos, consulte Event Management.

Tabela 6. Parâmetros

Nome	Tipo	Descrição
chave	Cadeia de caracteres	Nome da chave a ser adicionada ou atualizada no evento. Para obter informações adicionais sobre os campos de evento predefinidos, consulte Formato de campo de evento para coleção de eventos.
valor	Cadeia de caracteres	Informações a serem armazenadas no campo de evento associado. Nota: A cadeia de caracteres value é ajustada antes de ser armazenada, em que vários espaços são substituídos por um único espaço.

Tabela 7. Retorna

Tipo	Descrição
vazio

var event = new Event();
event.setField("source","SAP Solman");
event.setField("severity","3");
event.setField("time_of_event", "2019-18-05 13:12:05");
event.setField("type", "SAP object");
event.setField("user", "admin"); // parameter will be added to additional_info section       

Evento - setText(cadeia de caracteres text)

Define o campo description do evento associado ao valor passado.

Nota:

Você também pode usar o método Evento - setField(cadeia de caracteres chave, cadeia de caracteres valor) para definir o campo text no evento atual. Ao contrário do método setField(), este método não apara o texto passado.

Tabela 8. Parâmetros

Nome	Tipo	Descrição
texto	Cadeia de caracteres	Texto a ser armazenado no campo description do evento associado. Tamanho máximo: 4000 caracteres

Tabela 9. Retorna

Tipo	Descrição
vazio

var event = new Event();
event.setText("SAP Solman");       

Evento - setTimeOfEvent(cadeia de caracteres timeOfEvent)

Define o campo time_of_event no evento associado ao valor de hora UTC passado.

Nota:

Você também pode usar o método Evento - setField(cadeia de caracteres chave, cadeia de caracteres valor) para definir o campo time_of_event.

Tabela 10. Parâmetros

Nome	Tipo	Descrição
timeOfEvent	Cadeia de caracteres	Valor de hora UTC a ser definido no campo time_of_event. Formato: "aaaa-MM-dd HH:mm:ss" Tamanho máximo: 40 caracteres

Tabela 11. Retorna

Tipo	Descrição
vazio

var event = new Event();
event.setTimeOfEvent("2019-18-05 13:12:05");