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 melhorar o registro em log e a depuração.

Antes de Iniciar

Para adicionar mensagens de log ao script, você precisará usar a função Write-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é Tudo > 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 para 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 estiver 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, DEBUG 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é Tudo > Automação de Processo > Flow Designer > Propriedades.
   2. Localizar Especifique o nível de log das entradas de log do sistema a serem replicadas para o log de fluxo. O sistema replica somente entradas de log do nível especificado ou superior e as define como INFO ou DEBUG.

   Depois de criar e executar o script do PowerShell, os logs ficam disponíveis no log do MID Agent. A configuração desta propriedade também permite que você as 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 script do PowerShell, adicione mensagens de log e níveis com a função Write-SNCLog.

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

   Nome	Descrição
   Funçãode gravação-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 necessá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: Write-SNCLog - Nível WARN - Mensagem "aviso de log" Write-SNCLog WARN "aviso de log" Ambos os exemplos registram WARN: log warning.
   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, em seguida, teste e execute-o.

O que Fazer Depois

Os novos logs estão disponíveis no log do MID Agent e podem ser baixados do MID Server. Para obter mais informações, consulte Download dos 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