Trabalhando com o Agendador de relatórios

(A partir do UIM 20.3.3) Você pode usar o Agendador de relatórios para programar exibições de métricas ou relatórios de SLA (Service Level Agreement - Acordo de nível de serviço) para serem executados em horários especificados.  Os relatórios podem ser enviados no formato PDF por email ou FTP, ou ainda podem ser armazenados em um servidor. Este artigo explica como você pode trabalhar com tarefas no Agendador de relatórios. Ele descreve como criar, editar, excluir, visualizar, copiar e executar tarefas. Também fornece informações sobre como exibir o histórico de uma tarefa e como exibir o arquivo de log de cada tarefa executada.
A ilustração a seguir fornece uma visão geral:
Os tópicos a seguir fornecem as informações necessárias:
2
  • Você deve ter a permissão de ACL do Agendador de relatórios para trabalhar com a funcionalidade do Agendador de relatórios.
  • Para um ambiente do OC com vários nós, a funcionalidade do Agendador de relatórios no UIM 20.3.3 não oferece mais suporte à propriedade de configuração job_refresh_secs na seção /webapps/reportscheduler do wasp.cfg. Agora, há suporte para a propriedade de configuração execute_email_action na seção /webapps/reportscheduler do arquivo wasp.cfg. A propriedade execute_email_action permite impedir os relatórios duplicados, interrompendo a execução das ações de email em um ou mais servidores do OC. Em cada servidor do OC que você deseja parar de executar as ações de email, adicione a propriedade execute_email_actions com um valor false. Portanto, com essa propriedade, é possível resolver o problema de usuários que recebem relatórios duplicados em um ambiente do OC de vários nós.
A ilustração a seguir ajuda a entender rapidamente como é possível acessar e criar um cronograma de relatórios:
Criar uma tarefa
Para programar um relatório, é necessário criar uma tarefa.O processo completo de criação de tarefas inclui três etapas: configurar os detalhes do cronograma, especificar quando programar a tarefa e fornecer informações sobre o mecanismo de entrega.
Siga estas etapas:
  1. Acesse a opção
    Configurações
    na UI do OC.
  2. Clique no bloco
    Report Schedules
    .
    A página
    Report Schedules
    será aberta.
  3. Clique no botão
    Criar
    .
    A caixa de diálogo
    Create Schedule
    será exibida.
  4. Forneça as seguintes informações na seção
    Detalhes da programação
    :
    1. Digite um nome para o relatório no campo
      Salvar como
      .
    2. Selecione a opção
      Ativado
      para permitir que a tarefa seja executada.
    3. Digite uma descrição significativa no campo
      Descrição
      .
    4. Atribua a tarefa a uma conta da lista suspensa
      Conta
      .
    5. Selecione o tipo de relatório na lista suspensa
      Tipo de relatório
      . Você pode selecionar as exibições de métrica ou o SLA.
    6. Selecione o relatório necessário na lista suspensa
      Relatório
      .
    7. Se você tiver selecionado o tipo de relatório como SLA, faça uma seleção na lista suspensa
      SLA Depth
      . O padrão é SLA completo. Da mesma forma, se você tiver selecionado o tipo de relatório como exibições de métrica, faça uma seleção na lista suspensa do
      intervalo de tempo do relatório
      . O padrão é Último dia completo.
      A opção
      SLA completo
      é a que fornece mais detalhes, mas utiliza mais recursos do que as outras opções.
    8. (Para exibições de métricas) Se necessário, selecione um
      Intervalo de agregação
      de dados diferente. O padrão é Automático. Para imprimir a tarefa nas configurações do relatório, é necessário alterar o valor de
      Report Time Frame
      para que corresponda ao limite de tempo do relatório e o valor do
      Intervalo de agregação
      para que corresponda ao intervalo de agregação do relatório.
      Você pode alterar o intervalo de agregação de dados para cada nova tarefa. Isso não irá alterar o intervalo de agregação no relatório salvo. Quando se salva uma tarefa, suas seleções de limite de tempo e intervalo de agregação são salvas.
    9. Clique em
      Next
      .
      A seção
      Agendamento
      será exibida.
  5. Forneça as seguintes informações na seção
    Agendamento
    :
    1. Selecione uma opção na lista suspensa
      Executar
      . A área
      Run On
      será atualizada dinamicamente com base na sua seleção.
    2. Especifique a hora e a data da execução do relatório. Use a lista suspensa
      Fuso horário
      para selecionar o fuso horário para o relatório. O fuso horário selecionado determina quando a tarefa será executada e qual o fuso horário exibido no relatório. Se não selecionar um fuso horário, o fuso horário local será usado por padrão.
      A tarefa será executada no primeiro horário especificado depois da hora de início definida.
    3. Clique em
      Next
      .
      A seção
      Entrega
      será exibida.
  6. Forneça as seguintes informações na seção
    Entrega
    :
    1. Se você selecionar
      Email
      , digite as informações nos campos
      Para
      ,
      Assunto
      e
      Mensagem
      . Além disso, certifique-se de que as Configurações do servidor SMTP já estejam definidas.
    2. Se você selecionar
      FTP
      , digite as informações nos campos obrigatórios. É possível usar o campo
      FTP Location
      para especificar um subdiretório para salvar o relatório. Por exemplo, digite relatórios/mensal para salvar o relatório em um subdiretório chamado mensal. A opção
      FTP Passive
      permite que você defina o modo de FTP passivo ou ativo. O modo passivo será recomendável se o servidor do OC e o servidor FTP estiverem separados por um firewall.Clique em
      Testar conexão
      para validar a conexão FTP.
    3. Selecione
      Armazenar no servidor
      se desejar salvar os relatórios no servidor do OC (.. \webapps\reportscheduler\archive).Também é possível configurar o local de armazenamento do relatório em um servidor.
    4. Selecione a orientação do layout do relatório na lista suspensa
      Report Orientation
      .
    5. Selecione o tamanho do layout do relatório na lista suspensa
      Report Size
      .
  7. Clique em
    Criar
    .
A tarefa será criada e listada na tabela de tarefas Report Schedules.
Exibir a tabela Report Schedules
A tabela de tarefas Report Schedules lista as tarefas que foram criadas.
Clique em um cabeçalho da coluna para classificar a lista de tarefas por coluna e, em seguida, clique novamente para alternar entre ordem crescente e decrescente. Você também pode inserir um texto no campo de filtro para localizar a tarefa relevante. Este ícone indica que a tarefa está ativada. Este ícone indica que a tarefa está desativada.
Você pode executar as operações adequadas nas tarefas criadas com base em seus requisitos.
Configurar o local de armazenamento em um servidor
Uma das opções de entrega no Agendador de relatórios é armazenar os relatórios em um servidor. Por padrão, os relatórios são armazenados no diretório-raiz \webapps\reportscheduler\archive, mas é possível definir o diretório-raiz para armazenar os relatórios. Se o relatório estiver associado a uma conta, o relatório é armazenado em um diretório com esse nome de conta no diretório raiz especificado.
Siga estas etapas:
  1. Abra o Gerenciador de infraestrutura.
  2. Clique no robô do hub principal na exibição em árvore.
  3. Clique no probe wasp, no painel superior direito, para selecioná-lo.
  4. Pressione CTRL e clique com o botão direito do mouse; em seguida, selecione Configuração de dados brutos no menu pop-up.
  5. Expanda a pasta webapps na exibição em árvore da janela Configuração de dados brutos.
  6. Clique em Agendador de relatórios na exibição em árvore. As chaves do agendador de relatórios são exibidas no painel à direita.
  7. Clique em Nova chave. A caixa de diálogo New key é exibida.
  8. Digite file_store_root no campo Enter key name.
  9. Digite o caminho do diretório que deseja usar como diretório raiz para armazenar os relatórios no campo Enter value.
  10. Clique em OK e, em seguida, clique em OK novamente para fechar a janela Configuração de dados brutos.
  11. Reinicie o probe wasp.
Gerenciar tarefas
Depois de criar uma tarefa, você poderá executar várias operações nela para gerenciá-la de maneira eficiente. A captura de tela a seguir mostra as opções que podem ser executadas como parte do gerenciamento de tarefas:
Siga estas etapas:
  1. Execute uma tarefa
    Pode-se executar uma tarefa a qualquer momento. O relatório é enviado por meio do(s) método(s) de entrega. Executar uma tarefa não afeta a programação normal da tarefa.
    1. Localize a tarefa que deseja executar.
    2. Clique no ícone
      Run Job
      (ícone de reprodução) disponível na coluna Ações.
    A tarefa será executada e o relatório será enviado por meio do método de entrega especificado. O relatório recebe a nomenclatura <nome_da_tarefa>_<DiaMêsAno>_<HoraMinutosSegundos>.pdf. Qualquer símbolo ou caractere inválido no nome da tarefa são removidos.
  2. Copie uma tarefa
    É possível fazer uma cópia de uma tarefa existente. Isso é útil caso queira criar outra tarefa com configurações semelhantes.
    1. Localize a tarefa que deseja copiar.
    2. Clique no ícone Copiar tarefa.
    A cópia da tarefa será criada, nomeada como Cópia de <nome da tarefa> e será listada na tabela. Pode-se editar as configurações da cópia.
  3. Exclua uma tarefa
    É possível excluir tarefas que já não são mais necessárias. Ao excluir uma tarefa, todos as execuções dessa tarefa, bem como seu histórico, também são excluídos.
    1. Localize a tarefa que deseja excluir.
    2. Clique no ícone Excluir tarefa (ícone de lixeira).
    3. Confirme a exclusão da tarefa.
    A tarefa será excluída e removida da tabela.
  4. Visualize um relatório
    É possível exibir o PDF de um relatório sem enviá-lo usando os métodos de entrega selecionados. Isso também oferece uma maneira fácil de salvar o relatório em seu computador.
    1. Localize a tarefa cujo relatório você deseja visualizar.
    2. Clique nos três pontos da coluna Ações.
    3. Clique em Preview Report.
    Um PDF do relatório será gerado em seu navegador.
  5. Exiba o histórico da tarefa
    É possível exibir o histórico da tarefa. Por exemplo, você deseja exibir o arquivo de log de cada execução de uma tarefa. O arquivo de log inclui informações como ações realizadas, tempo, status e erros.
    1. Localize a tarefa cujo histórico você deseja exibir.
    2. Clique nos três pontos da coluna Ações.
    3. Clique em Mostrar histórico.
    A caixa de diálogo Schedule History será exibida. Ela contém o histórico da tarefa. Clique no status da entrada necessária. O log é exibido.Você também poderá acessar o arquivo de log a partir de uma mensagem de erro caso uma tarefa não tenha obtido êxito. A mensagem êxito/sem êxito, juntamente com um link para exibir o arquivo de log, será exibida.
Você executou com êxito as ações necessárias.
Configurar servidor de email
Para fornecer relatórios por email, o Agendador de relatórios deve ser configurado para usar o servidor SMTP.
Siga estas etapas:
  1. Abra a UI do Agendador de relatórios.
  2. Clique na opção Configuração de email na seção superior direita. A caixa de diálogo
    Configuração de email
    será aberta.
  3. Digite o endereço de email que o servidor SMTP pode usar no campo
    Do endereço de email
    .
  4. Digite o nome (
    Servidor SMTP
    ) e o número da porta (
    Porta SMTP
    ) do servidor SMTP.
  5. Digite um nome de usuário válido (
    Nome de usuário
    ) e a senha (
    Senha
    ) para o servidor SMTP.
  6. Se necessário, selecione uma ou mais das opções de segurança:
    • Usar autenticação
    • Usar STARTTLS
  7. Clique em
    Concluído
    para salvar as alterações.
As configurações do servidor de email foram definidas com êxito.