Para crear tareas programadas, primero configure los permisos adecuados mediante la creación de las siguientes políticas de IAM:

1. Cree un grupo dinámico para permitir que las tareas programadas publiquen métricas en el servicio de supervisión desde un compartimento específico:

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

   Como alternativa, para permitir que las métricas se publiquen desde todos los compartimentos:

   ALL {resource.type='loganalyticsscheduledtask'}

2. Cree políticas para permitir que el grupo dinámico realice operaciones de tareas programadas en el arrendamiento:

   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 read compartments in tenancy

• Algunas de las sentencias de política anteriores se incluyen en las plantillas de políticas definidas por Oracle fácilmente disponibles. Puede que desee considerar el uso de la plantilla para su caso de uso. Consulte Plantillas de políticas definidas por Oracle para casos de uso comunes.

• Para obtener información sobre grupos dinámicos y políticas de IAM, consulte Documentación de OCI: gestión de grupos dinámicos y Documentación de OCI: gestión de políticas.

• Para obtener información sobre la política, consulte Creación de consultas de métricas - Requisitos en la documentación de Oracle Cloud Infrastructure.

• Para conocer la referencia de la API de ScheduledTask, consulte Referencia de ScheduledTask en la documentación de la API de Oracle Cloud Infrastructure.

Para ver las tareas programadas para una búsqueda guardada específica, puede visitar la página de detalles de búsqueda guardada. Sin embargo, si desea mostrar todas las tareas programadas en un compartimento específico sin hacer referencia a las búsquedas guardadas para las que se hayan creado las tareas programadas, utilice la API para consultar la lista de tareas programadas. Consulte ListScheduledTasks.

Especifique los siguientes parámetros en el comando GET:

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

Para ejecutar el comando, necesitará:

• Espacio de nombre: espacio de nombre de Logging Analytics que ha especificado al crear las tareas programadas.
• OCID de compartimento: OCID del compartimento que desea consultar para obtener la lista de tareas programadas creadas en él.

Puede supervisar el estado de las tareas programadas de búsqueda guardada mediante las métricas Estado de ejecución de tarea programada. En caso de ejecución fallida u omitida de una tarea debido a una anomalía de la infraestructura o si se modifica un recurso o configuración dependiente, la métrica proporciona detalles del fallo para ayudarle a rectificarlo.

Para obtener información sobre los pasos para acceder a la métrica Estado de ejecución de tarea programada, consulte Supervisión de Logging Analytics con métricas de servicio.

Cada tarea programada de búsqueda guardada tiene su propio intervalo según lo especificado en su programa de tarea. Se emite una métrica a su arrendamiento para cada ejecución de tarea programada. Pase el cursor por los puntos de datos del gráfico para ver más detalles sobre la tarea. Siga estos pasos cuando desee filtrar los datos de métrica en función de una de las dimensiones Status, DisplayName o ResourceId:

1. Haga clic en el menú Opciones de la esquina superior derecha de la métrica Estado de ejecución de tarea programada y seleccione Ver consulta en el explorador de métricas.

   La métrica se muestra ahora en el explorador de métricas. Aquí, puede ver el gráfico con más detalle.

2. Haga clic en Editar consultas y seleccione Nombre de la dimensión y Valor de la dimensión para la métrica. Puede filtrar los datos de métrica según taskResult, el resultado de la ejecución de la tarea programada, Status de la ejecución de la tarea, DisplayName de la tarea, queryExecTimeRange o ResourceId.

   Nota
   
   

   Para ver gráficos y datos tabulares desde el explorador de métricas especificando un nombre de dimensión y un valor de dimensión, evite utilizar campos que tengan paréntesis u otros caracteres especiales en el nombre. Si el campo seleccionado para el nombre de dimensión tiene caracteres especiales, cree un campo virtual mediante el comando eval o cambie el nombre del campo existente mediante el comando rename para que se eliminen los paréntesis o los caracteres especiales. Por ejemplo, si el campo utilizado para el nombre de dimensión es Host Name (Server), puede crear un campo virtual hostname con | eval hostname=“Host Name (Server)”.

   La dimensión queryExecTimeRange es útil para determinar el tiempo que se tarda en ejecutar la consulta de tarea programada. Los valores disponibles son < 5s, >= 5s and < 10s, >= 10s and < 30s y > 30s. Normalmente, las consultas que tardan más de 30 segundos en ejecutarse se consideran costosas en términos de tiempo de ejecución. Consulte How to Make Your Queries Performant.

   La dimensión taskResult puede tener los valores Succeeded, Failed y Paused. La dimensión Status proporciona más detalles de taskResult. Por ejemplo, si el valor de taskResult es Paused, el valor de Status puede ser Paused by User.

   Haga clic en Actualizar gráfico para refrescar la visualización del gráfico. El gráfico ahora mostrará solo los puntos de datos para los que aplicó el filtro.

   Puede cambiar a la vista Tabla de datos para obtener una representación tabular de los puntos de datos recopilados.

3. Cambie el nombre de la dimensión para ver diferentes perspectivas en el gráfico.

Puede configurar alertas para notificarle sobre el estado a través de correo electrónico, SMS, Slack, PagerDuty, URL de punto final HTTPS o Función. Consulte Create Alerts for Detected Events.

A continuación se muestran los distintos valores de la dimensión status informados a través de esta métrica para valores taskResult específicos:

Tome nota de los siguientes factores para crear tareas programadas:

• Requisitos para componer consultas:

  Al redactar consultas para crear tareas programadas, asegúrese de cumplir los siguientes requisitos:

  • Tenga en cuenta estas limitaciones para las consultas de reglas de detección:

    • No realice la búsqueda con comodines en el campo Contenido de log original de la consulta de tarea programada. Para obtener más información sobre las búsquedas con comodines, consulte Uso de palabras clave, frases y comodines.

    • El comando timestats no puede ir seguido de eval, extract, jsonextract, xmlextract y lookup.

    • El comando regex no se debe utilizar en campos grandes como Message para evitar que las consultas resulten costosas para su procesamiento.

      Los comandos de comparación like y extract, jsonextract, xmlextract no están soportados en campos grandes como Message.

      Los campos o campos de enlace utilizados en la cláusula BY no se pueden utilizar en campos grandes como Message.

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

  • Límites máximos:

    El número máximo de campos soportados para la cláusula by es 3.

    El número máximo de campos admitidos para el comando timestats es 3.

    El número máximo de funciones de agregación soportadas en una consulta de tarea programada es 1.

  • Utilice los valores de los campos link como dimensiones para contabilizar métricas:

    Seleccione hasta tres campos de dimensión y una métrica numérica para contabilizar en el servicio de supervisión. Para indicar qué campos se deben publicar en la supervisión, las consultas deben terminar con:

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

    El comando link tiene varias columnas en la salida, como Hora de inicio, Hora de finalización, Recuento, etc., por defecto. Utilice -* en el comando fields para eliminar estos campos y especificar, opcionalmente, hasta tres campos de dimensión y un campo de métrica obligatorio.

    Puede tener varias sentencias eval después del comando stats y varias funciones stats para calcular resultados intermedios. Sin embargo, la consulta debe terminar con fields -*, dim1, dim2, dim3, metric1, que indica qué dimensiones y métricas se deben publicar. Utilice las siguientes directrices para las consultas de reglas de detección:

    • Utilice hasta el comando 2 addfields.
    • Utilice hasta 3 funciones stats.
    • Las sentencias eval son necesarias para calcular los resultados intermedios y finales.

    Consultas de ejemplo:

    '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

• Late Arrival of Logs:

  Si las tareas programadas se ejecutan antes de la llegada de los logs, es posible que las tareas programadas no devuelvan los resultados como se esperaba. Para evitar que falten dichos logs en las tareas programadas debido a su llegada tardía, la consulta debe contabilizarla mediante un ajuste en el rango de tiempo.

  Por ejemplo, si la tarea programada se ejecuta cada 5 minutos para comprobar el número de errores de autenticación y si hay un retraso de 3 minutos entre la hora de generación de los logs y la hora a la que llegan a Oracle Logging Analytics, la tarea programada no detectará los logs. Tenga en cuenta que la tarea programada se ejecuta cada 5 minutos, por ejemplo, a las 01:00, 01:05, 01:10, etc. Si el registro de log L1 que se genera a las 01:04 llega a Oracle Logging Analytics a las 01:07. L1 no se ha detectado en la tarea programada que se ha ejecutado a la 1:05 porque el log no ha llegado a Oracle Logging Analytics en este momento. Durante la siguiente ejecución a las 01:10, la consulta busca logs con registros de hora entre las 01:05 y las 01:10. También en este ciclo, L1 no se detecta porque tiene un registro de hora de 01:04. Es posible que la siguiente consulta no vea todos los registros de logs si los logs llegan tarde:

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

  Para determinar el retraso en la llegada de los logs a Oracle Logging Analytics, calcule la diferencia entre el registro de hora mencionado en el registro de log y el Hora de contabilización del procesador de log. La siguiente consulta de ejemplo se puede utilizar para comprobar si hay un retraso:

  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)'

  La siguiente consulta utiliza la función dateRelative para ajustar el retraso de 3 minutos en una tarea que se ejecuta en un intervalo de 5 minutos:

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

• Otros factores:

  • Para saber cómo se crean las consultas en el servicio Monitoring, consulte Creación de consultas de métricas en la documentación de Oracle Cloud Infrastructure.

  • Tenga en cuenta la información de límites para publicar los datos de métricas en el servicio Monitoring. Los límites corresponden a las métricas de una tarea programada. Consulte PostMetricData API en la documentación de Oracle Cloud Infrastructure.

    Cuando la búsqueda guardada puede generar más de 50 valores únicos por campo, se contabilizan resultados parciales debido a los límites impuestos por el servicio Monitoring. En estos casos, para ver los resultados top o bottom 50, utilice el comando sort.