Rastrear arquivos atualizados com uma tarefa do observador

A Automação do Azure usa uma tarefa de observação para procurar eventos e acionar ações com runbooks do PowerShell. A tarefa do observador contém duas partes, o observador e a ação. Um runbook do observador é executado em um intervalo estabelecido pela tarefa de observação e envia dados para um runbook de ação.

Este artigo orienta você na criação de uma tarefa do inspetor para monitorar quando um novo arquivo é adicionado a um diretório. Você aprende a:

• Importar um runbook do observador
• Criar uma variável de automação
• Criar um manual de operações
• Criar uma tarefa de observador
• Acionar um observador
• Inspecione a saída

Pré-requisitos

Para concluir este artigo, é necessário o seguinte:

• Subscrição do Azure. Se você ainda não tiver um, poderá ativar seus benefícios de assinante do MSDN ou se inscrever para uma conta gratuita.
• Conta de automação para manter os runbooks de monitorização e de ação e a Tarefa do Monitor.
• Um runbook worker híbrido onde a tarefa de monitorização é executada.
• Manuais de execução do PowerShell. Os runbooks do PowerShell Workflow e os runbooks gráficos não são suportados pelas tarefas de monitorização.

Importar um runbook do observador

Este artigo utiliza um runbook chamado Watcher runbook que procura novos ficheiros num diretório para procurar novos ficheiros num diretório. O runbook do observador recupera o último tempo de gravação conhecido para os arquivos em uma pasta e examina todos os arquivos mais recentes do que essa marca d'água.

Você pode importar esse runbook para sua conta de automação do portal usando as etapas a seguir.

1. Inicie sessão no portal Azure.
2. Pesquise e selecione Contas de automação.
3. Na página Contas de automação , selecione o nome da sua conta de automação na lista.
4. No painel esquerdo, selecione Galeria de Runbooks em Automação de Processos.
5. Verifique se o GitHub está selecionado na lista suspensa Origem .
6. Procure por runbook do Watcher.
7. Selecione Watcher runbook que procura novos arquivos em um diretório e selecione Importar na página de detalhes.
8. Dê ao runbook um nome e, opcionalmente, uma descrição e clique em OK para importar o runbook para sua conta de automação. Você deverá ver uma mensagem Importação concluída num separador no canto superior direito da sua janela.
9. O runbook importado aparece na lista sob o nome que você lhe deu quando você seleciona Runbooks no painel esquerdo.
10. Clique no runbook e, na página de detalhes do runbook, selecione Editar e, em seguida, clique em Publicar. Quando solicitado, clique em Sim para publicar o runbook.

Você também pode baixar o runbook da Azure Automation GitHub organization.

1. Navegue até a página da organização no GitHub de Automação do Azure para Watch-NewFile.ps1.
2. Para baixar o runbook do GitHub, selecione Código no lado direito da página e, em seguida, selecione Baixar ZIP para baixar todo o código em um arquivo zip.
3. Extraia o conteúdo e importe o runbook.

Criar uma variável de automação

Uma variável de automação é usada para armazenar os marcadores temporais que o runbook anterior lê e armazena de cada ficheiro.

1. Selecione Variáveis em Recursos compartilhados e clique em + Adicionar uma variável.

2. Introduza Watch-NewFileTimestamp como nome.

3. Selecione DateTime para o tipo. O padrão será para a data e hora atuais.

   

4. Clique em Criar para criar a variável Automation.

Criar um manual de operações

Um runbook de ação é usado em uma tarefa do observador para agir sobre os dados passados a ele a partir de um runbook do observador. Você deve importar um runbook de ação predefinido, seja do portal do Azure ou da organização do GitHub de Automação do Azure.

Você pode importar este runbook para sua conta de automação do portal do Azure:

1. Inicie sessão no portal Azure.
2. Pesquise e selecione Contas de automação.
3. Na página Contas de automação , selecione o nome da sua conta de automação na lista.
4. No painel esquerdo, selecione Galeria de Runbooks em Automação de Processos.
5. Verifique se o GitHub está selecionado na lista suspensa Origem .
6. Procure Ação do Watcher, selecione Ação do Watcher que processa eventos acionados por um runbook do Watcher e clique em Importar.
7. Opcionalmente, altere o nome do runbook na página de importação e clique em OK para importar o runbook. Você verá uma mensagem Importar com êxito no painel de notificação no canto superior direito do navegador.
8. Vá para a página da sua Conta de Automação e clique em Runbooks à esquerda. Seu novo runbook deve ser listado sob o nome que você deu a ele na etapa anterior. Clique no runbook e, na página de detalhes do runbook, selecione Editar e, em seguida, clique em Publicar. Quando solicitado, clique em Sim para publicar o runbook.

Para criar um runbook de ação baixando-o da organização do GitHub de Automação do Azure:

1. Navegue até a página da organização do GitHub de Automação do Azure para Process-NewFile.ps1.
2. Para baixar o runbook do GitHub, selecione Código no lado direito da página e, em seguida, selecione Baixar ZIP para baixar todo o código em um arquivo zip.
3. Extraia o conteúdo e importe o runbook.

Criar uma tarefa de observador

Nesta etapa, você configura a tarefa do inspetor fazendo referência aos runbooks do inspetor e da ação definidos nas seções anteriores.

1. Navegue até sua conta de automação e selecione Tarefas do inspetor em Automação de processos.

2. Selecione a página Tarefas do inspetor e clique em + Adicionar uma tarefa do inspetor.

3. Digite WatchMyFolder como o nome.

4. Selecione Configurar observador e escolha o runbook Watch-NewFile .

5. Insira os seguintes valores para os parâmetros:

   • FOLDERPATH - Uma pasta no Hybrid Runbook Worker onde novos arquivos são criados, por exemplo, d:\examplefiles.
   • EXTENSION - Extensão para a configuração. Deixe em branco para processar todas as extensões de arquivo.
   • RECURSE - Operação recursiva. Deixe esse valor como padrão.
   • RUN SETTINGS - Configuração para executar o runbook. Escolha o trabalhador híbrido.

6. Clique em OK; em seguida, Selecionar para voltar à página Observador.

7. Selecione Configurar ação e escolha o Process-NewFile runbook.

8. Insira os seguintes valores para os parâmetros:

   • EVENTDATA - Dados do evento. Deixe em branco. Os dados são passados a partir do runbook do observador.
   • Configurações de Execução - Configuração para executar o runbook. Deixe como Azure, pois este runbook é executado na Automação do Azure.

9. Clique em OK; em seguida, Selecionar para voltar à página Observador.

10. Clique em OK para criar a tarefa do inspetor.

    

Acionar um observador

Você deve executar um teste conforme descrito abaixo para garantir que a tarefa do inspetor funcione conforme o esperado.

1. Aceda remotamente ao Hybrid Runbook Worker.
2. Abra o PowerShell e crie um arquivo de teste na pasta.

New-Item -Name ExampleFile1.txt

O exemplo a seguir mostra a saída esperada.

    Directory: D:\examplefiles


Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----       12/11/2017   9:05 PM              0 ExampleFile1.txt

Inspecione a saída

1. Navegue até sua conta de automação e selecione Tarefas do inspetor em Automação de processos.

2. Selecione a tarefa do inspetor WatchMyFolder.

3. Clique sobre Ver fluxos do observador em Fluxos para ver que o observador encontrou o novo ficheiro e executou o runbook de ação.

4. Para ver os trabalhos do runbook de ação, clique em Exibir trabalhos de ação do observador. Cada trabalho pode ser selecionado para visualizar os detalhes do trabalho.

   

A saída esperada quando o novo arquivo é encontrado pode ser vista no exemplo a seguir:

Message is Process new file...

Passed in data is @{FileName=D:\examplefiles\ExampleFile1.txt; Length=0}

Próximos passos

Para saber mais sobre como criar seu próprio runbook, consulte Criar um runbook do PowerShell.