Documentación de Oracle Cloud Infrastructure

link

Utilice el comando link para agrupar los registros de log en transacciones de negocio de alto nivel. Con este comando se devuelve el enlace por campos junto con los siguientes detalles:

Temas:

Nota

Estos son algunos de los límites asociados al comando link:

  • El número máximo de grupos devueltos por la exportación de consulta o búsqueda de consulta mediante la consola, la CLI o el SDK es 500 cuando la consulta contiene un comando link.

    Sin embargo, se pueden procesar hasta 1 millón de grupos en una ejecución de consulta de enlace y los datos se pueden agrupar y visualizar mediante el comando classify

  • El número máximo de campos que se pueden incluir en el comando link es 4. Si el tiempo es uno de los campos, el límite máximo es 5.

Sintaxis

link [<link_options>] <fieldName> [, <fieldName>), ...]

Para obtener más información sobre link_options, como includeinfo, includenulls, includetrends, span, consulte la tabla a continuación.

Parámetros

En la siguiente tabla se muestran los parámetros utilizados en este comando, junto con sus descripciones.

Parámetro Descripción

includeinfo

Incluye la tabla de metadatos de consulta en los resultados. El valor por defecto es false.

Consulte Tabla de información de consultas generada con la opción includeinfo.

includenulls

Indica si los resultados deben incluir registros de log en los que los campos de enlace por son nulos. El valor por defecto es false.

includetrends

Indica si los resultados deben incluir datos de tendencias. El valor por defecto es true.

span

Define el tiempo que se utilizará para el histograma de resultados.

Sintaxis: <int><timescale>.

Sintaxis de timescale: <sec> | <min> | <hour> | <day> | <week> | <mon>

  • valores de sec: s | sec | secs | second | seconds
  • valores de min: m | min | min | minute | minutes
  • Valores de hour: h | hr | hrs | hour | hours
  • Valores de day: d | día | días
  • Valores de week: w | week | weeks
  • valores de mon: mon | month | months

Campos generados por link para cada grupo

El comando link produce una fila por grupo. Un grupo es la combinación única de las claves de entrada. Por ejemplo:

  • link 'Host Name (Server)' produce una fila para cada nombre de host. En este caso, un grupo es un nombre de host único.
  • link 'Host Name (Server)', 'User Name' produce una fila para cada combinación única del nombre de host y el nombre de usuario. En este caso, un grupo es una combinación única de nombre de host y nombre de usuario.

Los siguientes campos se generan automáticamente para cada grupo:

Campo Descripción
Recopilación Nombre de la recopilación en la que se mantienen la información. Se utiliza con el comando linkdetails
ID ID de grupo único en la recopilación
Recuento Número de registros de log en un grupo. En esta interfaz de usuario, puede hacer clic en este campo para ver los registros de log. También puede utilizar Mayús-Clic para seleccionar una o más filas en la interfaz de usuario para ver todos esos registros de log o agrupar en clusters los registros de log mediante las siguientes opciones, respectivamente:
  • Haga clic en Mostrar y seleccione Registros de log.
  • Haga clic en Mostrar y seleccione Clusters.
Hora de inicio Primer registro de hora de los registros de log dentro del grupo
Hora de finalización El último registro de hora de los registros de log dentro del grupo
Duración de grupo Duración de los registros de log en un grupo. Este campo está oculto por defecto en la interfaz de usuario. Puede mostrar este campo haciendo clic en Opciones y seleccionando la opción Ocultar/Mostrar columnas.

Además, también se generan los siguientes campos para todos los grupos. También se ocultan por defecto en la interfaz de usuario y se pueden mostrar haciendo clic en Opciones y seleccionando Ocultar/Mostrar columnas:

Campo Descripción
Hora de Inicio de Consulta Hora de inicio de la consulta seleccionada mediante el selector de hora. Si sustituye el tiempo especificando un rango de tiempo explícito en la consulta, se utiliza.
Hora de finalización de consulta Hora de finalización de la consulta seleccionada mediante el selector de hora. Si sustituye el tiempo especificando un rango de tiempo explícito en la consulta, se utiliza.
Intervalo de tendencia Intervalo especificado en el parámetro span para el comando link. Este es el intervalo utilizado para timestats y otros gráficos. Si no se ha especificado span, se utiliza un valor por defecto.
Unidad de intervalo de tendencia Unidad del intervalo especificado en el parámetro span para el comando link.

Para ver ejemplos del uso de este comando en escenarios habituales, consulte:

Con el siguiente comando se agrupan todos los logs fatales por transacción:

severity = fatal | link 'Transaction ID'

Con el siguiente comando se agrupan todos los logs fatales por transacción y se obtiene el tiempo medio transcurrido de los registros de log dentro de cada grupo:

severity = fatal | link 'Transaction ID' | stats avg('Elapsed Time (System)') as 'Average Elapsed Time'