Paramètres d'URL de l'explorateur de journaux

L'explorateur de journaux prend en charge plusieurs paramètres d'URL qui permettent de transmettre le contexte à l'application. Dans l'explorateur de journaux, cliquez sur Actions et sélectionnez Copier l'URL de requête pour obtenir un lien qui recharge la page telle qu'elle est actuellement affichée.

Paramètres de visualisation et de requête

Les paramètres de visualisation et de requête permettent aux intégrateurs de communiquer à l'explorateur de journaux les filtres de visualisation et de requête par défaut à utiliser lors du chargement de la page.

Paramètre Description Valeurs prises en charge Exemple
viz Définit la visualisation
  • pie
  • bar : barre verticale
  • hbar : barre horizontale
  • line
  • sunburst
  • treemap
  • cloud
  • map
  • records
  • table
  • records_histogram
  • table_histogram
  • distinct
  • cluster
  • link
  • tile
  • summary_table

Url : loganalytics/explorer?viz=records_histogram

Résultat : Logging Analytics se charge avec le graphique Enregistrements avec histogramme et la requête par défaut appropriée pour cette visualisation.

rechercher Met à jour la clause de recherche de la requête -
  • Test d'un groupe de mots :

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

    Requête résultante : 'Failed to start' | stats count as logrecords by 'Log Source' | sort -logrecords

  • Testez chaque mot :

    Url : loganalytics/explorer?search=Failed start

    Requête résultante : Failed and start | stats count as logrecords by 'Log Source' | sort -logrecords

  • Test d'un mot ou d'un autre :

    Url : loganalytics/explorer?search=Failed or start

    Requête résultante : Failed or start | stats count as logrecords by 'Log Source' | sort -logrecords

filtres Met à jour la requête avec les vérifications de champ/valeur spécifiées. Les filtres sont spécifiés avec un nom de champ, une valeur et un comparateur facultatif. Par défaut, le comparateur EQUALS est utilisé.

Les délimiteurs des filtres sont __:__ __,__ __;__

Comparateurs pris en charge :

  • EQUALS (valeur par défaut)
  • NOT_EQUALS
  • STARTS_WITH
  • DOES_NOT_START_WITH
  • ENDS_WITH
  • DOES_NOT_END_WITH
  • CONTAINS
  • 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
  • Un seul champ vérifie si le champ est défini sur NULL :

    Url : loganalytics/explorer?filters=ospid

    Autres URL :

    loganalytics/explorer?filters=OS Process ID

    loganalytics/explorer?filters='OS Process ID'

    Requête résultante : 'OS Process ID' = null | stats count as logrecords by 'Log Source' | sort -logrecords

  • Un champ et une valeur testent si le champ est égal à la valeur :

    Url : loganalytics/explorer?filters=ospid__:__889

    Requête résultante : 'OS Process ID' = 889 | stats count as logrecords by 'Log Source' | sort -logrecords

  • Un champ, une valeur et un comparateur testent la valeur du comparateur de champ :

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

    Requête résultante : 'OS Process ID' != 889 | stats count as logrecords by 'Log Source' | sort -logrecords

  • Filtres multiples (pour les comparaisons complexes) :

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

    Requête résultante : 'OS Process ID' != 889 and 'OS Process ID' < 3000 | stats count as logrecords by 'Log Source' | sort -logrecords

  • Valeurs multiples:

    Url (problèmes élevés et médicaux au cours des 14 derniers jours) : loganalytics/explorer?filters=Problem Priority__:__High__,__Medium__:__equals&timeNum=14&timeUnit=days

    Requête résultante : 'Problem Priority' in (High, Medium) | stats count as logrecords by 'Log Source' | sort -logrecords

    Paramètres de nettoyage de la mémoire résultant : comme les paramètres temporels sont également définis dans ce cas, l'option Heure est définie sur Last 14 Days.

  • Cas d'erreur :

    Si les combinaisons champ/valeur ne correspondent pas, une erreur s'affiche. Par exemple, filters=ospid:abc renvoie une erreur, car ospid est de type Long et abc est de type String.

encodedQuery

Décode la requête encodée base64 à partir de l'URL et met à jour la requête dans l'explorateur de journaux.

Dans javascript, vous pouvez créer le fichier encodedQuery à l'aide de window.btoa(requête). Décodez à l'aide de window.atob(encodedQuery).

Cela empêche le pare-feu de marquer certains caractères dans la requête. Par exemple, cette requête sera marquée par le pare-feu à l'aide des paramètres de requête non codés : 'Previous State' != 'Current State' | eval z = substr(a, 0, 1).

-

URL avec requête encodée :

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

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

La requête décodée est * | stats count as logs by 'Log Source'

Ensuite, le paramètre Priorité du problème est ajouté à la recherche, ce qui donne lieu à : 'Problem Priority' in (High, Medium) | stats count as logs by 'Log Source'

Paramètres de contexte global

Lorsque Logging Analytics exécute une requête, seul un sous-ensemble d'enregistrements de journal est pris en compte. L'ensemble des enregistrements de journal est déterminé en tenant compte du contexte global. Cela inclut des paramètres tels que le compartiment et l'heure.

Paramètre Description Valeurs prises en charge Exemple
startTime L'heure de début, UTC en millisecondes, est utilisée conjointement avec endTime. Si les deux sont fournis sur l'URL, une période personnalisée est définie dans la console. Date en millisecondes (UTC)

Par exemple, si vous exécutez la commande suivante dans la console, vous obtiendrez deux nombres : l'heure de début et l'heure de fin. Vous pouvez les connecter à l'URL et voir les données des 30 dernières minutes :

var now = new Date();

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

var endTime = now.getTime();

Exemple d'URL avec les heures de début et de fin : /loganalytics/explorer?startTime=1603735757388&endTime=1603737557388

Le résultat est une heure personnalisée dans l'explorateur de journaux avec ces valeurs définies comme heure de début et de fin.

L'heure est également prise en charge au format suivant :

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

endTime L'heure de fin, UTC en millisecondes, est utilisée conjointement avec startTime. Si les deux sont fournis sur l'URL, une période personnalisée est définie dans la console. Date en millisecondes (UTC) Reportez-vous à startTime.
timeNum L'explorateur de journaux prend en charge les temps relatifs, comme Last 7 days. Pour spécifier un jeu de temps relatif timeNum sur un nombre et timeUnit sur la période requise. Nombre supérieur à 0 /loganalytics/explorer?timeNum=42&timeUnit=minutesor/loganalytics/explorer?timeNum=1&timeUnit=day
timeUnit L'explorateur de journaux prend en charge les temps relatifs, comme Last 7 days. Pour spécifier une heure relative, définissez timeNum sur un nombre et timeUnit sur la période requise.
  • SECONDES
  • MINUTES
  • HEURES
  • Jours
  • SEMAINES
  • MOIS
  • ANS
Reportez-vous à timeNum.
scopeFilters Ce paramètre permet de transmettre des filtres de portée tels que le compartiment du groupe de journaux, l'entité et l'ensemble de journaux.

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

où :

  • 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