Configurar registro em log para a etapa do PowerShell

Adicione mensagens de log aos scripts na etapa do PowerShell. Use níveis de log para registro em log e depuração aprimorados.

Antes de Iniciar

Para adicionar mensagens de log ao seu script, você precisará usar a função Gravar-SNCLog. Esta função é definida no módulo IH\Logging.psm1. Use PSScript.ps1 para importar este módulo para que os scripts em linha tenham acesso a Write-SNCLog. Para obter mais informações, consulte Arquivos do PowerShell do MID Server.

Função necessária: administrador

Procedimento

1. Navegar até Todos > MID Server > Propriedades.
2. Defina mid.property.powershell.log_info como verdadeiro.
   Esta propriedade habilita ou desabilita o registro em log. Para obter mais informações, consulte Propriedade de log do PowerShell.
3. Defina mid.property.powershell.ih.log_level com o nível de log desejado.
   O nível de log especifica o limite necessário para registrar uma mensagem. As mensagens são registradas em log no nível especificado ou superior. Por exemplo, se esta propriedade for definida como WARN, as mensagens com um nível de WARN ou ERROR serão registradas em log. Mensagens com um nível de INFO, DEPURAÇÃO ou TRACE não são registradas em log. Os níveis, listados de baixo para alto, são:

   • TRACE
   • DEBUG
   • INFORMAÇÕES
   • WARN
   • ERRO

   O valor padrão é INFO.
4. Opcional: Configure uma propriedade do sistema para que você possa exibir os logs na instância.
   1. Navegar até Todos > Automação de Processo > Flow Designer > Propriedades.
   2. Localizar Especifique o nível de log das entradas de log do sistema para replicar para o log de fluxo. O sistema replica somente entradas de log do nível especificado ou superior e as define como INFO ou DEPURAÇÃO.

   Depois de criar e executar o script do PowerShell, os logs ficam disponíveis no log do agente MID. Configurar esta propriedade também permite que você os exiba diretamente na instância.

   Esta etapa define a propriedade com.glide.hub.flow_engine.listener_trace.threshold. Ele replica os logs para a tabela de entradas de log do mecanismo de fluxo [sys_flow_log].

5. No seu script do PowerShell, adicione mensagens de log e níveis com a função Gravar-SNCLog.

   Tabela 1. Função e parâmetros de Write-SNCLog

   Nome	Descrição
   Funçãode gravação de SNCLog	Registre uma mensagem para a etapa do PowerShell. O Write-SNCLog tem dois parâmetros, -Level e -Message. Ambos os parâmetros são obrigatórios, mas os nomes dos parâmetros não são. Se os nomes forem omitidos, a posição será usada para determinar o nível e a mensagem. Exemplos: Gravar-SNCLog - Nível WARN - Mensagem "aviso de log" Gravar-SNCLog WARN "aviso de registro em log" Ambos os exemplos registram WARN: log aviso.
   Parâmetro -Level	Especifique o nível da mensagem de log. Os valores válidos são: ERRO WARN INFORMAÇÕES DEBUG TRACE Este parâmetro é obrigatório.
   Parâmetro -Message	Especifique a mensagem a ser registrada. Inserido como uma cadeia de caracteres. Este parâmetro é obrigatório.

6. Continue criando sua ação ou fluxo e teste e execute-o.

O que Fazer Depois

Os novos logs estão disponíveis no log do agente MID e podem ser baixados do MID Server. Para obter mais informações, consulte Baixar os arquivos do MID Server.

Se você definir a propriedade do sistema para exibir os logs na instância, poderá vê-los na guia Entradas de log do mecanismo de fluxo do registro de contexto do mecanismo de fluxo. Para obter mais informações, consulte Detalhes da execução do fluxo.

Tarefas relacionadas

• Testar uma credencial para a etapa do PowerShell