Esta página ha sido traducida por una máquina.

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 vuelve 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 visualización y consulta por defecto se deben utilizar al cargar la página.

Parámetro Descripción Valores soportados Ejemplo
viz 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: Logging Analytics se carga con el gráfico Registros con histograma y la consulta por defecto 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 de resultado: '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 de resultado: 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 nombre de campo, 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 como nulo:

    Url: loganalytics/explorer?filters=ospid

    URL alternativas:

    loganalytics/explorer?filters=OS Process ID

    loganalytics/explorer?filters='OS Process ID'

    Consulta de resultado: '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 de resultado: '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 de resultado: 'OS Process ID' != 889 | stats count as logrecords by 'Log Source' | sort -logrecords

  • Filtros múltiples (para comparaciones complejas):

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

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

  • Varios Valores:

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

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

    Configuración de GC de resultado: dado 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 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 mediante window.atob(encodedQuery).

Esto evita que el firewall marque determinados caracteres en la consulta. Por ejemplo, esta consulta se marcará mediante el firewall 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, se agrega el parámetro Prioridad del problema 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 Logging Analytics ejecuta una consulta, solo se considera un subjuego de registros de log. El juego de registros de log se determina teniendo en cuenta el contexto global. Esto incluye valores como compartimento y tiempo.

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

La hora también se admite 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 ambos se proporcionan en la URL, se define un marco temporal personalizado en la consola. Fecha en milisegundos de UTC Consulte startTime.
timeNum Log Explorer soporta tiempos relativos, como Last 7 days. Para especificar un valor de tiempo relativo, establezca 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 Log Explorer 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

¿Le ha resultado útil este artículo?