Para criar Tarefas Programadas, primeiro configure as permissões corretas criando as seguintes políticas do serviço IAM:

1. Crie um grupo dinâmico para permitir que Tarefas Programadas publiquem métricas no serviço de monitoramento de um compartimento específico:

   ALL {resource.type='loganalyticsscheduledtask', resource.compartment.id='<compartment ocid>'}

   Como alternativa, para permitir que métricas sejam publicadas de todos os compartimentos:

   ALL {resource.type='loganalyticsscheduledtask'}

2. Crie políticas para permitir que o grupo dinâmico execute operações de Tarefa Programada na tenancy:

   allow group <group_name> to use loganalytics-scheduled-task in tenancy
   allow dynamic-group <dynamic_group_name> to use metrics in tenancy
   allow dynamic-group <dynamic_group_name> to read management-saved-search in tenancy
   allow dynamic-group <dynamic_group_name> to {LOG_ANALYTICS_QUERY_VIEW} in tenancy
   allow dynamic-group <dynamic_group_name> to {LOG_ANALYTICS_QUERYJOB_WORK_REQUEST_READ} in tenancy
   allow dynamic-group <dynamic_group_name> to READ loganalytics-log-group in tenancy
   allow dynamic-group <dynamic_group_name> to {LOG_ANALYTICS_LOOKUP_READ} in tenancy
   allow dynamic-group <dynamic_group_name> to read compartments in tenancy

• Algumas das instruções de política acima estão incluídas nos modelos de política definidos pela Oracle prontamente disponíveis. Talvez você queira considerar o uso do modelo para seu caso de uso. Consulte Modelos de Política definidos pela Oracle para Casos de Uso Comuns.

• Para obter informações sobre grupos dinâmicos e políticas do serviço IAM, consulte Documentação do OCI: Gerenciando Grupos Dinâmicos e Documentação do OCI: Gerenciando Políticas.

• Para obter os detalhes da política, consulte Criando Consultas de Métricas - Pré-requisitos na Documentação do Oracle Cloud Infrastructure.

• Para obter a referência da API de Tarefas Programadas, consulte Referência de Tarefa Programada na Documentação da API do Oracle Cloud Infrastructure.

Para exibir as tarefas programadas de uma pesquisa salva específica, você pode visitar a página de detalhes da pesquisa salva. No entanto, se você quiser listar todas as tarefas programadas em um compartimento específico sem fazer referência às pesquisas salvas para as quais as tarefas programadas foram criadas, use a API para consultar a listagem das tarefas programadas. Consulte ListScheduledTasks.

Especifique os seguintes parâmetros no comando GET:

• taskType=SAVED_SEARCH
• compartmentId=<compartment_OCID>
• limit=1000
• sortOrder=DESC
• sortBy=timeUpdated

Para executar o comando, você precisará:

• Namespace: O namespace do Logging Analytics que você especificou ao criar as tarefas programadas.
• OCID do Compartimento: O OCID do compartimento que você deseja consultar para obter a lista de tarefas programadas criadas nele.

Você pode monitorar a integridade das tarefas programadas da pesquisa salva por meio das métricas Status de Execução da Tarefa Programada. Em caso de execução com falha ou ignorada de uma tarefa devido a uma anomalia de infraestrutura ou se um recurso ou configuração dependente for modificado, a métrica fornecerá detalhes da falha para ajudá-lo a corrigi-la.

Para ver as etapas de acesso à métrica Status de Execução da Tarefa Programada, consulte Monitorar Métricas de Serviço do Logging Analytics.

Cada tarefa programada de pesquisa salva tem seu próprio intervalo, conforme especificado em sua programação de tarefa. Uma métrica é emitida para sua tenancy para cada execução de tarefa programada. Passe o cursor sobre os pontos de dados do gráfico para exibir mais detalhes sobre a tarefa. Siga estas etapas quando quiser filtrar os dados de métrica com base em uma das dimensões Status, DisplayName ou ResourceId:

1. Clique no menu Opções no canto superior direito da métrica Status de Execução da Tarefa Programada e selecione Exibir Consulta no Explorador de Métricas.

   A métrica agora é exibida no Explorador de Métricas. Aqui você pode ver o gráfico com mais detalhes.

2. Clique em Editar Consultas e selecione Nome da Dimensão e Valor da Dimensão para a métrica. Você pode filtrar os dados de métrica com base em taskResult o resultado da execução da tarefa programada, Status da execução da tarefa, o DisplayName da tarefa, o queryExecTimeRange ou seu ResourceId.

   Observação
   
   

   Para exibir gráficos e dados tabulares do Metrics Explorer especificando um nome de dimensão e um valor de dimensão, evite usar campos que tenham parênteses ou outros caracteres especiais no nome. Se o campo selecionado para o Nome da Dimensão tiver caracteres especiais, crie um campo virtual usando o comando eval ou renomeie o campo existente usando o comando rename de forma que os parênteses ou caracteres especiais sejam removidos. Por exemplo, se o campo usado para Nome da Dimensão for Host Name (Server), você poderá criar um campo virtual hostname com | eval hostname=“Host Name (Server)”.

   A dimensão queryExecTimeRange é útil para determinar o tempo necessário para executar sua consulta de tarefa programada. Os valores disponíveis são < 5s, >= 5s and < 10s, >= 10s and < 30s e > 30s. Normalmente, as consultas que levam mais de 30 segundos para serem executadas são consideradas caras em termos de tempo de execução. Consulte Como Tornar Suas Consultas Executivas.

   A dimensão taskResult pode ter os valores Succeeded, Failed e Paused. A dimensão Status fornece mais detalhes de taskResult. Por exemplo, se o valor de taskResult for Paused, o valor de Status poderá ser Paused by User.

   Clique em Atualizar Gráfico para atualizar a visualização do gráfico. O gráfico agora exibirá apenas os pontos de dados aos quais você aplicou o filtro.

   Você pode alternar para a view Tabela de Dados e ver uma representação tabular dos pontos de dados coletados.

3. Altere o nome da dimensão para exibir diferentes perspectivas no gráfico.

Você pode configurar alertas para notificá-lo sobre o status por e-mail, SMS, Slack, PagerDuty, URL do ponto final HTTPS ou Função. Consulte Criar Alertas para Eventos Detectados.

A seguir estão os vários valores da dimensão status reportados por meio dessa métrica para valores taskResult específicos:

Anote os seguintes fatores para criar tarefas agendadas:

• Requisitos para Criar Consultas:

  Ao compor consultas para criar Tarefas Programadas, certifique-se de cumprir os seguintes requisitos:

  • Observe estas limitações para consultas de regras de detecção:

    • Evite executar pesquisa com curinga no campo Conteúdo de Log Original na consulta de tarefa programada. Para obter mais informações sobre pesquisas de curingas, consulte Usar Palavras-chave, Frases e Curingas.

    • O comando timestats não pode ser seguido por eval, extract, jsonextract, xmlextract e lookup.

    • O comando regex não deve ser usado em campos grandes como Message para evitar tornar as consultas caras para processamento.

      A comparação like e os comandos extract, jsonextract e xmlextract não são suportados em campos grandes como Message.

      Campos de link ou campos usados na cláusula BY não podem ser usados em campos grandes como Message.

    • The commands which are not supported in the queries for scheduled tasks are cluster, clustercompare, clusterdetails, clustersplit, compare, createview, delta, eventstats, fieldsummary, highlightgroups, geostats, linkdetails, map, nlp and timecompare.

  • Limites máximos:

    O número máximo de campos suportados para a cláusula by é 3.

    O número máximo de campos suportados para o comando timestats é 3.

    O número máximo de funções agregadas suportadas em uma consulta de tarefa programada é 1.

  • Use os valores dos campos link como dimensões para postar métricas:

    Selecione até três campos de dimensão e uma métrica numérica para lançar no serviço de monitoramento. Para indicar quais campos devem ser lançados no monitoramento, as consultas devem terminar com:

    ... | link ... | fields -*, dim1, dim2, dim3, metric1

    O comando link tem várias colunas na saída, como Hora Inicial, Hora Final, Contagem etc. por padrão. Use -* no comando fields para remover esses campos e especificar opcionalmente até três campos de dimensão e um campo de métrica obrigatório.

    Você pode ter várias instruções eval após o comando stats e várias funções stats para calcular resultados intermediários. No entanto, a consulta deve terminar com fields -*, dim1, dim2, dim3, metric1 indicando quais dimensões e métricas devem ser postadas. Use as seguintes diretrizes para consultas de regras de detecção:

    • Use até o comando 2 addfields.
    • Use até 3 funções stats.
    • As instruções eval são necessárias para calcular resultados intermediários e finais.

    Exemplos de consultas:

    'Log Source' = 'OCI Email Delivery'
     | link 'Entity'
     | addfields [ * | where deliveryEventType = r and bounceType = hard | stats count as 'hard bounces' ],
                 [ * | where deliveryEventType = e and length(ipPoolName) > 0 | stats count as 'total sent messages' ]
     | eval 'Total Rate' = ('hard bounces' / 'total sent messages') * 100
     | fields -*, 'Entity', 'Total Rate'

    'Log Source' = 'My Network Logs'
     | stats sum(Success) as TotalSuccess, sum(Failure) as TotalFailure
     | eval SuccessRate = (TotalSuccess / (TotalSuccess + TotalFailure)) * 100 | fields -*, SuccessRate

• Chegada Atrasada de Logs:

  Se as tarefas programadas forem executadas antes da chegada dos logs, as tarefas programadas poderão não retornar os resultados conforme esperado. Para evitar a falta desses logs nas tarefas programadas devido à chegada atrasada, a consulta deve contabilizá-la usando um ajuste no intervalo de tempo.

  Por exemplo, se a tarefa programada for executada a cada 5 minutos para verificar o número de erros de autenticação e se houver um atraso de 3 minutos entre o momento em que os logs são gerados e o momento em que eles chegam ao Oracle Logging Analytics, a tarefa programada não detectará os logs. Considere que a tarefa agendada é executada a cada 5 minutos, digamos, 01:00, 01:05, 01:10 e assim por diante. Se o registro de log L1 gerado às 01:04 atingir o Oracle Logging Analytics às 01:07. L1 não foi detectado na tarefa programada que foi executada às 1:05 porque o log não chegou ao Oracle Logging Analytics no momento. Durante a próxima execução às 01:10, a consulta procura logs com timestamps entre 01:05 e 01:10. Neste ciclo também, L1 não é detectado porque tem um timestamp de 01:04. Talvez a seguinte consulta não veja todos os registros de logs se eles chegarem atrasados:

  Label = 'Authentication Error' | stats count as logrecords by 'Log Source'

  Para determinar o atraso na chegada dos logs ao Oracle Logging Analytics, calcule a diferença entre o timestamp mencionado no registro de log e o Horário de Publicação do Processador de Log. O exemplo de consulta a seguir pode ser usado para verificar se há um atraso:

  Label = 'Authentication Error' and 'Log Processor Posting Time (OMC INT)' != null | fields 'Agent Collection Time (OMC INT)', 'Data Services Load Time', 'Process Time', 'Log Processor Posting Time (OMC INT)'

  A consulta a seguir usa a função dateRelative para ajustar o atraso de 3 minutos em uma tarefa que é executada em um intervalo de 5 minutos:

  Label = 'Authentication Error' and Time between dateRelative(8minute, minute) and dateRelative(3minute, minute) | stats count as logrecords by 'Log Source'

• Outros Fatores:

  • Para entender como as consultas são criadas no serviço Monitoring, consulte Criando Consultas de Métricas na Documentação do Oracle Cloud Infrastructure.

  • Observe as informações de limites para publicar os dados de métricas no serviço Monitoring. Os limites correspondem às métricas de uma tarefa programada. Consulte PostMetricData API na Documentação do Oracle Cloud Infrastructure.

    Quando sua pesquisa salva pode gerar mais de valores 50 exclusivos por campo, resultados parciais são publicados devido aos limites impostos pelo serviço Monitoring. Nesses casos, para visualizar os resultados top ou bottom 50, use o comando sort.