AgentNowHandler - com escopo

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 3 min. de leitura

    • A inclusão de script AgentNowHandler permite executar definições de verificação sob demanda, verificar o status de execuções sob demanda e de verificação de teste e interromper verificações em segundo plano que foram executadas sob demanda.

    Esta inclusão de script requer a aplicação da loja Agent Client Collector Framework (sn_agent) e é fornecida no namespace sn_agent. Para obter mais informações, consulte Agent Client Collector.

    Para obter a solução REST API, consulte Agent Client Collector API.

    AgentNowHandler - AgentNowHandler()

    Cria uma instância do AgentNowHandler.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    Nenhum

    O exemplo a seguir mostra como inicializar o AgentNowHandler.

    var handler = new sn_agent.AgentNowHandler();

    AgentNowHandler - getRequestStatus(cadeia de caracteres requestId)

    Obtém o status da solicitação com o ID fornecido.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    requestId Cadeia de caracteres Um ID de solicitação de verificação gerado pela chamada do método runCheckForCis().
    Tabela 3. Retorna
    Propriedades Descrição
    Objeto Status da solicitação e qualquer mensagem de erro aplicável.
    status Status da solicitação.
    Valores possíveis:
    • concluído: a verificação foi bem-sucedida.
    • falha – Falha na verificação. Consulte a mensagem de erro para obter detalhes.
    • mid_flow: a saída da solicitação está sendo processada pelo MID Server.
    • processando: a verificação está em andamento.
    • timeout: verifica se o processamento excedeu o limite de tempo definido no método runCheckForCis().

    Tipo de dados: cadeia de caracteres
    erro_msg Mensagem de erro, se houver.
    Valores possíveis:
    • Nenhum agente encontrado para ICs relevantes.
    • Nenhuma solicitação de verificação de antecedentes com o ID fornecido.
    • Nenhuma solicitação com o ID fornecido.
    • Nenhum resultado de teste com o ID fornecido.
    • Tempo limite da solicitação.

    Tipo de dados: cadeia de caracteres

    O exemplo a seguir mostra como obter o status de uma solicitação.

    var handler = new sn_agent.AgentNowHandler();
var check = {checkDefId: "158279505372b30034b8ddeeff7b1270"};
var computerGr = new GlideRecord("cmdb_ci_computer");
computerGr.query();
var requestId = handler.runCheckForCis(computerGr, check, 0, 60);

var reqStatusJson = handler.getRequestStatus(requestId);
gs.info(JSON.stringify(reqStatusJson));

    AgentNowHandler - getTestResultStatus(cadeia de caracteres testResultId)

    Obtém o status de verificação do resultado do teste fornecido.

    Tabela 4. Parâmetros
    Nome Tipo Descrição
    IDResultadoDoteste Cadeia de caracteres Um ID de resultado de teste gerado pela criação de uma solicitação de verificação de teste.
    Tabela 5. Retorna
    Propriedades Descrição
    status Status dos resultados do teste.
    Valores possíveis:
    • 0: Pendente
    • 1: em andamento
    • 2: concluído
    • 3: nenhum resultado de teste com o ID fornecido

    Tipo de dados: cadeia de caracteres
    saída Saída que descreve o status.

    Tipo de dados: cadeia de caracteres

    O exemplo a seguir mostra como obter o status do resultado de uma solicitação de verificação de teste concluída.

    var testCheckStatusJson = handler.getTestResultStatus("testResultId");
gs.info(JSON.stringify(testCheckStatusJson));

    AgentNowHandler - runCheckForCis(objeto de segurança, verificação de objeto, prioridade de número, tempo limite de número)

    Executa uma verificação em relação ao item de configuração fornecido.

    Tabela 6. Parâmetros
    Nome Tipo Descrição
    ICs GlideRecord GlideRecord de qualquer tabela do CMDB (qualquer aplicação, host ou agente) em que a verificação está funcionando.
    verificar Objeto Contém o ID de verificação e os parâmetros de verificação opcionais. 
    {
  "checkDefId": "String",
  "params": Object
}
    check.checkDefId Cadeia de caracteres Sys_id de uma definição de verificação na tabela Definições de verificação [sn_agent_check_def].
    check.params Objeto Opcional. Mapa de nomes e valores de parâmetro. Essas configurações podem ser usadas para substituir os registros de parâmetro da definição de verificação e seus valores especificados. 
    "params": {
  "<parameter name>": "String"
}
    prioridade Número Prioridade da solicitação a ser definida na fila do ECC.
    Valores possíveis:
    • 0: interativo
    • 1: agilizado
    • 2: padrão
    tempo limite Número Valor do tempo limite da solicitação em segundos.
    Tabela 7. Retorna
    Tipo Descrição
    Cadeia de caracteres Sys_id da solicitação de verificação do histórico gerada.

    O exemplo a seguir mostra como executar uma verificação em segundo plano e obter seu ID de solicitação.

    var handler = new sn_agent.AgentNowHandler();
var check = {checkDefId: "028fcd5067c80010b7b72dbd2685ef4f"};
var computerGr = new GlideRecord("cmdb_ci_computer");
computerGr.query();
var requestId = handler.runCheckForCis(computerGr, check, 0, 60);

gs.info(requestId);

    Saída:

    b9cf14aedb5e30106f4810284b961990

    AgentNowHandler - stopBackgroundCheck(cadeia de caracteres requestId)

    Interrompe uma verificação em segundo plano.

    Para iniciar uma verificação em segundo plano, use o método runCheckForCis().

    Tabela 8. Parâmetros
    Nome Tipo Descrição
    requestId Cadeia de caracteres O ID de uma solicitação de verificação em segundo plano gerada pela chamada do método runCheckForCis().
    Tabela 9. Retorna
    Tipo Descrição
    Nenhum

    O exemplo a seguir mostra como parar de executar uma verificação em segundo plano.

    handler.stopBackgroundCheck(backRequestId);