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 l'interrogation pour obtenir un lien qui recharge la page exactement comme elle est actuellement affichée.

Paramètres de visualisation et d'interrogation

Les paramètres de visualisation et d'interrogation permettent aux intégrateurs de communiquer à l'explorateur de journaux les filtres de visualisation et d'interrogation par défaut qui doivent être utilisés lors du chargement de la page.

Paramètre Description Valeurs prises en charge Exemple
visualisation 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 l'interrogation par défaut appropriée pour cette visualisation.

search Met à jour la clause de recherche de l'interrogation -
  • Test pour un groupe de mots :

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

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

  • Test pour chaque mot :

    URL : loganalytics/explorer?search=Failed start

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

  • Test pour un mot ou un autre :

    Url : loganalytics/explorer?search=Failed or start

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

filtres Met à jour l'interrogation 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
  • CONTIENT
  • 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 testera si le champ est réglé à nul :

    Url : loganalytics/explorer?filters=ospid

    Autres URL :

    loganalytics/explorer?filters=OS Process ID

    loganalytics/explorer?filters='OS Process ID'

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

  • Un champ et une valeur seront testés si le champ est égal à la valeur :

    Url : loganalytics/explorer?filters=ospid__:__889

    Interrogation 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

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

  • Plusieurs filtres (pour les comparaisons complexes) :

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

    Interrogation 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 Med au cours des 14 derniers jours) : loganalytics/explorer?filters=Problem Priority__:__High__,__Medium__:__equals&timeNum=14&timeUnit=days

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

    Paramètres de récupération de mémoire résultant : Comme les paramètres de temps sont également définis dans ce cas, l'heure est réglée à Last 14 Days.

  • Cas d'erreur :

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

encodedQuery

Décode l'interrogation encodée base64 à partir de l'URL et met à jour l'interrogation dans l'explorateur de journaux.

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

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

-

URL avec interrogation 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

L'interrogation décodée est * | stats count as logs by 'Log Source'

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

Paramètres de contexte global

Lorsque Logging Analytics exécute une interrogation, 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 ce qui suit dans la console, vous obtiendrez deux nombres - heure de début et 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 heure de début et heure 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 heure de fin.

L'heure est également prise en charge dans le 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 Voir startTime.
timeNum L'explorateur de journaux prend en charge les temps relatifs, par exemple Last 7 days. Pour spécifier un temps relatif, réglez timeNum à un nombre et timeUnit à la période requise. Un 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, par exemple Last 7 days. Pour spécifier une heure relative, réglez timeNum à un nombre et timeUnit à la période requise.
  • SECONDES
  • MINUTES
  • HEURES
  • JOURS
  • SEMAINES
  • MOIS
  • ANNÉES
Voir timeNum.
scopeFilters Ce paramètre permet de transmettre des filtres de portée tels que le compartiment, l'entité et le jeu de journaux du groupe 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