Compartilhar via

  • Artigo

Logs de runbook

 

Publicado: março de 2016

Aplicável a: System Center 2012 SP1 - Orchestrator, System Center 2012 - Orchestrator, System Center 2012 R2 Orchestrator

Todos os runbooks geram um log durante a execução. O Runbook Designer permite que você exiba informações de logs em tempo real e logs históricos.

Log em tempo real

Você pode ver o log em tempo real de um runbook na guia Log do painel Log no Runbook Designer. O log tem uma entrada para cada instância em execução do runbook e a hora em que ela foi iniciada. Se você expandir esta entrada, poderá visualizar a atividade em execução no momento. Clique duas vezes na atividade para ver seus detalhes. Caso tenha configurado o log da pasta de trabalho para que inclua Dados publicados, essas informações estarão incluídas nos detalhes da atividade

Log de histórico

Você pode ver o histórico do log de um runbook na guia Histórico de log do painel Log no Runbook Designer. O log tem uma entrada para cada instância concluída do runbook com a hora em que ela foi iniciada e terminada, além do status da conclusão. Se você clicar duas vezes em uma entrada, a caixa de diálogo Detalhes do runbook é exibida, incluindo cada atividade no runbook e o status da conclusão. Clique duas vezes em cada atividade para ver seus detalhes. Caso tenha configurado o log da pasta de trabalho para que inclua Dados publicados, essas informações estarão incluídas nos detalhes da atividade

Opções de log de runbook

Por padrão, os logs de runbook não incluem Dados publicados para cada atividade. Para as atividades padrão, consulte Atividades Padrão para ver uma lista de itens de Dados publicados disponíveis em cada atividade. Para pacotes de integração, consulte o guia do pacote de integração específico. Você pode alterar as propriedades de log de um runbook específico para incluir essas informações nos logs. Você pode incluir um ou ambos os tipos de Dados publicados a seguir:

  • Dados publicados específicos da atividade são Dados publicados específicos de uma atividade em particular. Normalmente, essa opção deve ser ativada apenas para fins de depuração.

  • Dados publicados comuns são um conjunto de itens de dados que são comuns a todas as atividades. Estes são:

    • Nome da Atividade

    • Tipo de Atividade

    • ID da Atividade

    • Ano, mês, dia, dia da semana, horas, minutos e segundos de término da atividade

    • Duração da atividade

    • Atividade anterior

    • Nome da atividade anterior

    • Dados publicados de tempo

System_CAPS_ICON_caution.jpg Cuidado

Por padrão, as opções de log estão desabilitadas. Lembre-se de que a adição desses itens ao log aumenta o tamanho do armazenamento de dados.

Histórico de auditoria do runbook

O Histórico de auditoria do runbook monitora as alterações em cada atividade de um runbook. Isso inclui o usuário que fez a alteração, a data e a hora em que ela ocorreu, a atividade que foi alterada e os valores atuais e anteriores de qualquer propriedade alterada. O histórico de auditoria é mantido enquanto o runbook existir, e não pode ser eliminado.

Você pode visualizar o Histórico de auditoria do runbook na guia Histórico de auditoria do Runbook Designer. As entradas do runbook atualmente selecionado serão exibidas. Clique duas vezes em uma entrada para abrir a caixa de diálogo Detalhes, em que é possível visualizar uma lista com todas as atividades que fizeram parte da alteração. Selecione uma das entradas para ver a atividade que foi realizada, assim como os valores anteriores e novos de quaisquer propriedades alteradas.

Limpando logs de runbook

O Runbook Designer fornece um recurso de Limpeza de Log. Os dados de log do Orchestrator podem ser limpos sob demanda ou de forma programada. É uma boa prática agendar uma limpeza de log regular, fora do horário de pico, para manutenção do banco de dados.

System_CAPS_ICON_note.jpg Observação

Quando os logs são limpos, os dados são excluídos do banco de dados Orchestration e não podem ser recuperados.

Se você deixar o número de entradas no log aumentar de modo indiscriminado, isso poderá gerar requisitos excessivos de armazenamento para o banco de dados do Orchestrator. Para manter a integridade e o desempenho do banco de dados, você deve limpar regularmente entradas antigas no log. Você pode limpá-las com uma programação automática ou manualmente.

Limpar automaticamente os logs de runbook

Você pode agendar para que os log de runbook sejam limpos regularmente selecionando opções de frequência e o número de entradas a serem mantidas. Por padrão, os logs de runbook são limpos automaticamente com as configurações a seguir.

Configuração Valor padrão
Frequência Uma vez por dia
Hora 01:00:00
Manter Manter as últimas 5000 entradas

O trabalho de limpeza padrão de log apaga tudo, exceto as 500 entradas de log mais recentes de cada runbook. Isso significa que se uma implantação do Orchestrator tiver 20 runbooks, a limpeza padrão manteria as 500 entradas de log mais recentes para cada runbook, com um máximo de 10000 entradas de log no banco de dados para todos os runbooks.

Você pode continuar a usar esses padrões ou alterar as configurações usando o seguinte processo no Runbook Designer:

Para limpar runbooks sob demanda ou definir a frequência de limpeza

  1. No Runbook Designer, clique com o botão direito em Servidor Management para selecionar Limpeza de log.

    Se quiser limpar todos os runbooks agora, clique em Limpar agora.

    Se quiser limpar um runbook específico agora, clique na guia Histórico de log para selecionar o runbook a ser limpo.

  2. Certifique-se de que a opção Agendar limpeza de log esteja selecionada.

  3. Selecione o número de dias entre a execução do processo de limpeza e a hora para executar o processo.

  4. Se não quiser excluir todas as entradas, defina Opções de Limpeza de Log para especificar as entradas de log que você deseja manter.

  5. Clique em Finalizar.

Limpar logs de runbook manualmente

Logs de histórico de auditoria são um caso especial porque não podem ser limpos com o recurso Limpeza de log. O recurso de histórico de auditoria monitora as alterações feitas a um runbook no Runbook Designer e não podem ser excluídas. A única maneira de excluir os logs do Histórico de auditoria é excluir o runbook associado a eles. Porém, os volumes de dados de um log de Histórico de auditoria para um runbook qualquer geralmente são pequenos; mesmo em grandes implantações, o armazenamento desses logs não exigirá mais do que os requisitos mínimos de sistema

Há duas opções para limpar manualmente os logs de runbook, conforme mostrado nos dois procedimentos a seguir. Elas são realizadas no Runbook Designer.

Para limpar manualmente os logs de todos os runbooks

  1. Clique com o botão direito em Servidor Management para selecionar Limpeza de log.

  2. Defina Opções de Limpeza de Log para especificar as entradas de log que você deseja manter.

  3. Clique em Limpar Agora.

Para excluir manualmente todas as entradas de log de um único runbook

  1. No painel Conexões, selecione a pasta Runbooks.

  2. No painel de espaço de trabalho, clique na guia do runbook.

  3. No painel Histórico de Log, clique na guia Histórico de Log.

  4. Clique no ícone da Lixeira na parte superior do painel.

  5. Quando for perguntado se você tem certeza de que deseja limpar os logs, clique em Sim.

Para excluir um conjunto específico de entradas de log de um único runbook

  1. No painel Conexões, selecione a pasta Runbooks.

  2. No painel de espaço de trabalho, clique na guia do runbook.

  3. No painel Histórico de Log, clique na guia Histórico de Log.

  4. Selecione uma única entrada de log ou use a combinação de teclas Ctrl + Shift para selecionar múltiplas entradas.

  5. Clique no ícone vermelho Excluir na parte superior do painel.

  6. Quando for perguntado se você tem certeza de que deseja excluir as entradas selecionadas, clique em Sim.

Removendo entradas de log órfãs

Arquivos de log órfãos podem ser deixados no banco de dados Orchestration se o Runbook Server Service for interrompido de repente enquanto as instâncias de runbook estão sendo executadas Se isso acontecer, o status da instância do runbook não será atualizado corretamente com a hora final. Essas entradas serão removidas quando as entradas de log forem limpas usando um dos métodos de limpeza descritos abaixo. Se quiser remover entradas órfãs antes da próxima vez em que as entradas serão limpas, você poderá executar manualmente o procedimento armazenado ClearOrphanedRunbookInstances para efetuar esta tarefa.

O processo a seguir descreve como executar esse procedimento armazenado usando o Microsoft SQL Server Management Studio instalado no servidor do banco de dados Orchestration. Você pode efetuar esse processo de qualquer computador com essa ferramenta instalada que tenha acesso ao banco de dados Orchestration.

Para remover entradas de log órfãs

  1. No servidor com o banco de dados Orchestration, clique em Iniciar, aponte para Todos os programas, clique em Microsoft SQL Server 2008 e clique em SQL Server Management Studio.

  2. Na caixa de diálogo Conectar ao servidor, na lista Nome do servidor, selecione (local) e clique em Conectar.

  3. No Pesquisador de objetos, expanda Banco de dados e clique em Orchestrator.

    System_CAPS_ICON_note.jpg Observação

    Se você usou um nome diferente para o banco de dados do Orchestrator, selecione esse nome.

  4. Expanda Programação e clique em Procedimentos armazenados.

  5. Clique com o botão direito em Microsoft.SystemCenter.Orchestrator.Runtime.Internal.ClearOrphanedRunbookInstances para selecionar Executar procedimento armazenado.

  6. Na caixa de diálogo Executar procedimento, clique em OK.

  7. Na barra de ferramentas, clique em Executar.

  8. Quando receber uma mensagem na parte inferior do painel Log informando que a consulta foi concluída, feche o SQL Server Management Studio.

Consulte também

Logs do Orchestrator