Exibir o status de um trabalho de runbook
Aplica-se a: Windows Azure Pack for Windows Server
Quando você inicia um runbook no Service Management Automation, um trabalho é criado. Um trabalho é uma instância de execução única de um runbook. Um runbook único pode ter vários trabalhos, cada um com seu próprio conjunto de valores para os parâmetros do runbook. Há várias maneiras de verificar o status de um trabalho específico e de todos os trabalhos para um ou mais runbooks.
Status do trabalho
A tabela a seguir descreve os diferentes status possíveis para um trabalho.
Status |
Descrição |
|---|---|
Concluído |
O trabalho foi concluído com êxito. |
Falha |
O trabalho foi concluído com uma exceção. |
Em fila |
O trabalho está aguardando que os recursos de um Automation Worker fiquem disponíveis para que ele possa ser iniciado. |
Início |
O trabalho foi atribuído a um trabalhador e o sistema está iniciando-o. |
Retomada |
O sistema está retomando o trabalho depois de ter sido suspenso. |
Em execução |
O trabalho está em execução. |
Parado |
O trabalho foi interrompido pelo usuário antes de ser concluído. |
Parando com |
O sistema está começando a interromper o trabalho. |
Suspenso |
O trabalho foi suspenso pelo usuário, pelo sistema ou por um comando no runbook. Um trabalho suspenso pode ser iniciado novamente e será retomado a partir de seu último ponto de verificação ou, se não houver nenhum ponto de verificação, desde o início do runbook. O runbook somente será suspenso pelo sistema no caso de uma exceção quando houver a possibilidade de retomada. Por padrão, ErrorActionPreference é definido como Continue, o que significa que o trabalho continuará a ser executado em uma exceção. Se essa variável de preferência for definida como Stop, o trabalho será suspenso em uma exceção. |
Suspensão |
O sistema está tentando suspender o trabalho por solicitação do usuário. O runbook precisa atingir seu próximo ponto de verificação antes de poder ser suspenso. Se ele já passou seu último ponto de verificação, ele será concluído antes de poder ser suspenso. |
Exibindo o status do trabalho usando o Portal de Gerenciamento
Painel de automação
O painel de automação mostra um resumo de todos os runbooks no ambiente Service Management Automation. O gráfico de resumo mostra o número total de trabalhos para todos os runbooks que inseriram cada status em um determinado número de dias ou horas. Você pode selecionar o intervalo de tempo no canto superior direito do gráfico. O eixo de tempo do gráfico será alterado conforme o tipo de intervalo de tempo selecionado. Para escolher se deseja exibir a linha para um status específico, clique nele na parte superior da tela.
Você pode usar as etapas abaixo para exibir o painel de automação.
No Portal de gerenciamento, selecione Automação.
Selecione a guia Painel de Controle.
Painel do runbook
O painel do runbook mostra um resumo de um único runbook. O gráfico de resumo mostra o número total de trabalhos para o runbook que inseriu cada status em um determinado número de dias ou horas. Você pode selecionar o intervalo de tempo no canto superior direito do gráfico. O eixo de tempo do gráfico será alterado conforme o tipo de intervalo de tempo selecionado. Para escolher se deseja exibir a linha para um status específico, clique nele na parte superior da tela.
Você pode usar as etapas a seguir para exibir o painel do runbook.
No Portal de gerenciamento, selecione Automação.
Clique no nome de um runbook.
Selecione a guia Painel de Controle.
Resumo, histórico e origem do trabalho
Você pode exibir uma lista de todos os trabalhos que foram criados para um determinado runbook e seus status mais recentes. Você pode filtrar essa lista pelo status do trabalho e o intervalo de datas para a última alteração no trabalho. Clique no nome de um trabalho para exibir as informações detalhadas e sua saída. A exibição detalhada do trabalho inclui os valores dos parâmetros de runbook que foram fornecidos para esse trabalho.
O histórico de trabalho inclui as mensagens de saída, de aviso e de erro com carimbos de data/hora de quando o registro foi criado. Para saber mais sobre os registros que são gravados no histórico de trabalhos, consulte Mensagens e saída de runbook.
A fonte de um trabalho é o código-fonte do fluxo de trabalho quando o trabalho foi executado. Isso pode não ser o mesmo que a versão atual do runbook se ela foi atualizada depois de o trabalho ter sido executado.
Você pode usar as etapas a seguir para exibir os trabalhos de um runbook.
No Portal de gerenciamento, selecione Automação.
Clique no nome de um runbook.
Selecione a guia Trabalhos.
Clique na coluna Trabalho Criado de um trabalho para exibir seus detalhes e saída.
Selecione a guia Histórico para exibir o histórico do trabalho. Selecione um registro de histórico e clique em Exibir Detalhes na parte inferior da tela para uma exibição detalhada do registro.
Na guia Histórico, clique emExibir Fontena parte inferior da tela para a fonte do trabalho.
Recuperando o status do trabalho usando o Windows PowerShell
Você pode usar o Get-SmaJob para recuperar os trabalhos criados para um runbook e os detalhes de um trabalho específico. Se você iniciar um runbook com o Windows PowerShell usando Start-SmaRunbook, ele retornará o trabalho resultante. Use o Get-SmaJobOutput para obter a saída de um trabalho.
Os comandos de exemplo a seguir recuperam o último trabalho para um runbook de exemplo e exibem seu status, os valores fornecidos para os parâmetros de runbook e a saída do trabalho.
$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Test-Runbook"
$job = (Get-SmaJob –WebServiceEndpoint $webServer –Port $port –RunbookName $runbookName | sort LastModifiedDate –desc)[0]
$job.Status
$job.JobParameters
Get-SmaJobOutput –WebServiceEndpoint $webServer –Port $port -Id $job.Id –Stream Output
Consulte também
Service Management Automation
Operações de Runbook (antigo) [SMA]
Iniciando um Runbook (antigo) [SMA]