Parámetros de URL del explorador de logs

Log Explorer soporta varios parámetros de URL que permiten transferir el contexto a la aplicación. En el explorador de logs, haga clic en Acciones y seleccione Copiar URL de consulta para obtener un enlace que vuelva a cargar la página exactamente como se muestra actualmente.

Parámetros de visualización y consulta

Los parámetros de visualización y consulta permiten a los integradores comunicar al explorador de logs qué filtros de consulta y visualización por defecto se deben utilizar cuando se carga la página.

Parámetro Descripción Valores soportados Ejemplo
vis Define la visualización
  • pie
  • bar: barra vertical
  • hbar: barra horizontal
  • line
  • sunburst
  • treemap
  • cloud
  • map
  • records
  • table
  • records_histogram
  • table_histogram
  • distinct
  • cluster
  • link
  • tile
  • summary_table

Url: loganalytics/explorer?viz=records_histogram

Resultado: Log Analytics se carga con el gráfico Registros con histograma y la consulta por defecto que es adecuada para esta visualización.

buscar Actualiza la cláusula de búsqueda de la consulta -
  • Prueba de un grupo de palabras:

    Url: loganalytics/explorer?search='Failed to start'

    Consulta resultante: 'Failed to start' | stats count as logrecords by 'Log Source' | sort -logrecords

  • Prueba para cada palabra:

    Url: loganalytics/explorer?search=Failed start

    Consulta resultante: Failed and start | stats count as logrecords by 'Log Source' | sort -logrecords

  • Prueba de una palabra u otra:

    Url: loganalytics/explorer?search=Failed or start

    Consulta resultante: Failed or start | stats count as logrecords by 'Log Source' | sort -logrecords

filtros Actualiza la consulta con las comprobaciones de campo/valor especificadas. Los filtros se especifican con el nombre de campo, el valor y un comparador opcional. Por defecto, se utiliza el comparador EQUALS.

Los delimitadores para los filtros son __:__ __,__ __;__

Comparadores soportados:

  • EQUALS (valor por defecto)
  • NOT_EQUALS
  • STARTS_WITH
  • DOES_NOT_START_WITH
  • ENDS_WITH
  • DOES_NOT_END_WITH
  • CONTIENE
  • DOES_NOT_CONTAIN
  • IS_LESS_THAN
  • IS_LESS_THAN_OR_EQUAL_TO
  • IS_GREATER_THAN
  • IS_GREATER_THAN_OR_EQUAL_TO
  • IS_BETWEEN
  • IS_NOT_BETWEEN
  • Solo un campo probará si el campo está definido en nulo:

    Url: loganalytics/explorer?filters=ospid

    URL alternativas:

    loganalytics/explorer?filters=OS Process ID

    loganalytics/explorer?filters='OS Process ID'

    Consulta resultante: 'OS Process ID' = null | stats count as logrecords by 'Log Source' | sort -logrecords

  • Un campo y un valor probarán si el campo es igual al valor:

    Url: loganalytics/explorer?filters=ospid__:__889

    Consulta resultante: 'OS Process ID' = 889 | stats count as logrecords by 'Log Source' | sort -logrecords

  • Un campo, un valor y un comparador probarán el valor del comparador de campos:

    Url: loganalytics/explorer?filters=ospid__:__889__:__NOT_EQUALS

    Consulta resultante: 'OS Process ID' != 889 | stats count as logrecords by 'Log Source' | sort -logrecords

  • Varios filtros (para comparaciones complejas):

    Url: loganalytics/explorer?filters=ospid__:__889__:__NOT_EQUALS__;__ospid__:__3000__:__IS_LESS_THAN

    Consulta resultante: 'OS Process ID' != 889 and 'OS Process ID' < 3000 | stats count as logrecords by 'Log Source' | sort -logrecords

  • Varios Valores:

    Url (problemas altos y medicos de los últimos 14 días): loganalytics/explorer?filters=Problem Priority__:__High__,__Medium__:__equals&timeNum=14&timeUnit=days

    Consulta resultante: 'Problem Priority' in (High, Medium) | stats count as logrecords by 'Log Source' | sort -logrecords

    Configuración de GC resultante: debido a que los parámetros de tiempo también se definen en este caso, la hora se define en Last 14 Days.

  • Casos de error:

    Si las combinaciones de campo/valor no coinciden, se muestra un error. Por ejemplo, filters=ospid:abc produciría un error, porque ospid es un valor largo y abc es una cadena.

encodedQuery

Decodifica la consulta codificada base64 desde la URL y actualiza la consulta en el explorador de logs.

En javascript, puede crear encodedQuery mediante window.btoa(query). Decodifique con window.atob(encodedQuery).

Esto evita que el firewall marque determinados caracteres en la consulta. Por ejemplo, el firewall marcará esta consulta mediante los parámetros de consulta no codificados: 'Previous State' != 'Current State' | eval z = substr(a, 0, 1).

-

URL con consulta codificada:

Url: loganalytics/explorer?viz=pie&viz=pie&encodedQuery=KiB8IHN0YXRzIGNvdW50IGFzIGxvZ3JlY29yZHMgYnkgJ0xvZyBTb3VyY2Un

Ejemplo: loganalytics/explorer?viz=summary_table&filters=Problem Priority__:__High__,__Medium__:__equals&timeNum=14&timeUnit=days&encodedQuery=KiB8IHN0YXRzIGNvdW50IGFzIGxvZ3MgYnkgJ0xvZyBTb3VyY2Un

La consulta descodificada es * | stats count as logs by 'Log Source'

A continuación, el parámetro Prioridad de problema se agrega a la búsqueda que da como resultado: 'Problem Priority' in (High, Medium) | stats count as logs by 'Log Source'

Parámetros de contexto global

Cuando Log Analytics ejecuta una consulta, solo se tiene en cuenta un subjuego de registros de log. El juego de registros de log se determina teniendo en cuenta el contexto global. Esto incluye valores como el compartimento y el tiempo.

Parámetro Descripción Valores soportados Ejemplo
startTime La hora de inicio, UTC en milisegundos, se utiliza junto con endTime. Si se proporcionan ambos en la URL, se define un marco temporal personalizado en la consola. Fecha en milisegundos UTC

Por ejemplo, si ejecuta lo siguiente en la consola, obtendrá dos números: hora de inicio y hora de finalización. Puede conectarlos a la URL y ver los datos de los últimos 30 minutos:

var now = new Date();

var startTime = now.getTime() - (1000*60) *30;

var endTime = now.getTime();

URL de ejemplo con hora de inicio y finalización: /loganalytics/explorer?startTime=1603735757388&endTime=1603737557388

El resultado es una hora personalizada en el explorador de logs con estos valores definidos como hora de inicio y finalización.

La hora también está soportada en el siguiente formato:

/loganalytics/explorer?startTime=Mon Oct 26 2019 16:38:12 GMT-0400&endTime=Mon Oct 26 2020 16:38:12 GMT-0400

endTime La hora de finalización, UTC en milisegundos, se utiliza junto con startTime. Si se proporcionan ambos en la URL, se define un marco temporal personalizado en la consola. Fecha en milisegundos UTC Consulte startTime.
timeNum El explorador de logs soporta tiempos relativos, como Last 7 days. Para especificar un conjunto de tiempo relativo timeNum en un número y timeUnit en el marco temporal necesario. Un número mayor que 0 /loganalytics/explorer?timeNum=42&timeUnit=minutesor/loganalytics/explorer?timeNum=1&timeUnit=day
timeUnit El explorador de logs soporta tiempos relativos, como Last 7 days. Para especificar una hora relativa, establezca timeNum en un número y timeUnit en el marco temporal necesario.
  • SEGUNDOS
  • MINUTOS
  • HORAS
  • DÍAS
  • SEMANAS
  • MESES
  • AÑOS
Consulte timeNum.
scopeFilters Este parámetro permite transferir filtros de ámbito como el compartimento de grupo de logs, la entidad y el juego de logs.

scopeFilters=lg:<logGroupFilter>;en:<entityFilter>;lgste:<logSetFilter>;rg:<regionFilter>;lfe:<logFieldFilter>;mc:<metricCompartmentFilter>;rs:<resourceCompartmentFilter>

donde:

  • logGroupFilter = <logCompartmentOcid>,<includeSubComponents(true/false)>

  • entityFilter = <entityCompartmentOcid>,<includeDependents(true/false)>,<entityOcid>,<entityOcid>,...

  • logSetFilter (encoded)= <logSetNameEncoded>,<logSetNameEncoded>....

  • regionFilter = <region> (For example, us-phoenix-1)

  • logFieldFilter (encoded) = <fieldName>:<fieldValueEncoded>

  • resourceCompartmentFilter = <resourceCompartmentOcid>,<includeSubComponents(true/false)>

  • metricCompartmentFilter = <metricCompartmentOcid>,<includeSubComponents(true/false)>

/loganalytics/explorer?&scopeFilters=lg:root,true;en:root,true,ocid1...;rs:root,true;lfe:Severity,ZXJyb3I=;rg:us-phoenix-1