Documentação do Oracle Cloud Infrastructure

Parâmetros do URL do Log Explorer

O Log Explorer suporta vários parâmetros de URL que permitem que o contexto seja passado para o aplicativo. No Log Explorer, clique em Ações e selecione Copiar URL de consulta para obter um link que recarrega a página exatamente como está exibida no momento.

Parâmetros de Visualização e Consulta

Os parâmetros de visualização e consulta permitem que os integradores comuniquem ao Log Explorer quais filtros de visualização e consulta padrão devem ser usados quando a página é carregada.

Parâmetro Descrição Valores suportados Exemplo
viz Define a visualização
  • 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: O Log Analytics é carregado com o gráfico Registros com Histograma e a consulta padrão apropriada para essa visualização.

pesquisar Atualiza a cláusula de pesquisa da consulta -

  • Teste para um grupo de palavras:

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

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

  • Teste para cada palavra:

    Url: loganalytics/explorer?search=Failed start

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

  • Teste para uma palavra ou outra:

    Url: loganalytics/explorer?search=Failed or start

    Consulta Resultante: Failed or start | stats count as logrecords by 'Log Source' | sort -logrecords
filtros Atualiza a consulta com as verificações de campo/valor especificadas. Os filtros são especificados com nome de campo, valor e um comparador opcional. Por padrão, o comparador EQUALS é usado.

Os delimitadores para filtros são __:__ __,__ __;__

Comparadores suportados:

  • EQUALS (valor padrão)
  • NOT_EQUALS
  • STARTS_WITH
  • DOES_NOT_START_WITH
  • ENDS_WITH
  • DOES_NOT_END_WITH
  • CONTÉM
  • 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

  • Apenas um campo testará se o campo está definido como nulo:

    Url: loganalytics/explorer?filters=ospid

    Urls Alternativos:

    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

  • Um campo e um valor serão testados se o campo for igual ao valor:

    Url: loganalytics/explorer?filters=ospid__:__889

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

  • Um campo, valor e comparador testará o valor do comparador de campo:

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

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

  • Vários filtros (para comparações complexas):

    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

  • Vários Valores:

    Url (Problemas de alta e média dos últimos 14 dias): 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

    Definições de GC Resultantes: Como os parâmetros de tempo também são definidos nesse caso, o Tempo é definido como Last 14 Days.

  • Casos de erro:

    Se as combinações de campo/valor não corresponderem, um erro será exibido. Por exemplo, filters=ospid:abc geraria um erro, porque ospid é um Longo e abc é uma String.

encodedQuery

Decodifica a consulta codificada base64 do URL e atualiza a consulta no Log Explorer.

No javascript, você pode criar a encodedQuery usando window.btoa(query). Decodifique usando window.atob(encodedQuery).

Isso impede que o firewall sinalize determinados caracteres na consulta. Por exemplo, essa consulta será sinalizada pelo firewall usando os parâmetros de consulta não codificados: 'Previous State' != 'Current State' | eval z = substr(a, 0, 1).

-

URL com consulta codificada:

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

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

A consulta decodificada é * | stats count as logs by 'Log Source'

Em seguida, o parâmetro Prioridade do Problema é adicionado à pesquisa, resultando em: 'Problem Priority' in (High, Medium) | stats count as logs by 'Log Source'

Parâmetros de Contexto Global

Quando o Log Analytics executa uma consulta, apenas um subconjunto de registros de log é considerado. O conjunto de registros de log é determinado levando-se em consideração o contexto global. Isso inclui definições como compartimento e tempo.

Parâmetro Descrição Valores suportados Exemplo
startTime O horário de início, UTC em Milissegundos, é usado em conjunto com endTime. Se ambos forem fornecidos no URL, um intervalo personalizado será definido no console. Data em milissegundos UTC

Por exemplo, se você executar o seguinte no console, você receberá dois números - hora de início e hora de término. Você pode conectá-los ao URL e ver os dados nos últimos 30 minutos:

var now = new Date();

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

var endTime = now.getTime();

URL de Amostra com Horário Inicial e Final: /loganalytics/explorer?startTime=1603735757388&endTime=1603737557388

O resultado é uma hora personalizada no Log Explorer com esses valores definidos como a hora de início e de término.

O tempo também é suportado no seguinte formato:

/loganalytics/explorer?startTime=Mon Oct 26 2019 16:38:12 GMT-0400&endTime=Mon Oct 26 2020 16:38:12 GMT-0400
endTime O horário final, UTC em Milissegundos, é usado em conjunto com startTime. Se ambos forem fornecidos no URL, um intervalo personalizado será definido no console. Data em milissegundos UTC Consulte startTime.
timeNum O Log Explorer suporta horários relativos, como Last 7 days. Para especificar um tempo relativo, defina timeNum como um número e timeUnit como o período necessário. Um número maior que 0 /loganalytics/explorer?timeNum=42&timeUnit=minutesor/loganalytics/explorer?timeNum=1&timeUnit=day
timeUnit O Log Explorer suporta horários relativos, como Last 7 days. Para especificar um tempo relativo, defina timeNum como um número e timeUnit como o período necessário.
  • SEGUNDOS
  • MINUTOS
  • Horas
  • DIAS
  • SEMANAS
  • MESES
  • ANOS
 Consulte timeNum.
scopeFilters Este parâmetro permite que filtros de escopo, como compartimento do grupo de logs, entidade e conjunto de logs, sejam passados.

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

em que:

  • 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