Documentação do Oracle Cloud Infrastructure

link

Use o comando link para agrupar registros de log em transações de negócios de alto nível. Esse comando retorna o link por campos, com os seguintes detalhes:

Tópicos:

Observação

Estes são alguns dos limites associados ao comando link:

  • O número máximo de grupos retornados pela pesquisa ou exportação de consulta usando a console, a CLI ou o SDK é 500 quando a consulta contém um comando link.

    No entanto, é possível processar até 1 milhão de grupos em uma execução de consulta de link e os dados podem ser agrupados e visualizados usando o comando classify

  • O número máximo de campos que podem ser incluídos no comando link é 4. Se o tempo for um dos campos, o limite máximo será 5.

Sintaxe

link [<link_options>] <fieldName> [, <fieldName>), ...]

Para obter detalhes sobre link_options, como includeinfo, includenulls, includetrends, span, consulte a tabela abaixo.

Parâmetros

A tabela a seguir lista os parâmetros usados nesse comando, com suas descrições.

Parâmetro Descrição

includeinfo

Inclui a tabela de metadados de consulta nos resultados. O valor padrão é false.

Consulte Tabela de Informações de Consulta Gerada com a Opção includeinfo.

includenulls

Indica se os resultados devem incluir registros de log nos quais o link por campos é nulo. O valor padrão é false.

includetrends

Indica se os resultados devem incluir dados de tendência. O valor padrão é true.

span

Define o tempo a ser usado para o histograma de resultados.

Sintaxe: <int><timescale>.

timescale sintaxe: <sec> | <min> | <hour> | <day> | <week> | <mon>

  • sec valores: s | sec | secs | second | seconds
  • min valores: m | min | mins | minute | minutes
  • hour valores: h | hr | hrs | hora | horas
  • day valores: d | dia | dias
  • week valores: w | semana | semanas
  • mon valores: mon | month | months

Campos Gerados por link para Cada Grupo

O comando link produz uma linha por grupo. Grupo é a combinação exclusiva de chaves de entrada. Por exemplo:

  • link 'Host Name (Server)' produz uma linha para cada nome de host. Neste caso, um grupo é um nome de host exclusivo.
  • link 'Host Name (Server)', 'User Name' produz uma linha para cada combinação exclusiva do nome do host e do nome do usuário. Neste caso, um grupo é uma combinação exclusiva de nome de host e nome de usuário.

Os seguintes campos são gerados automaticamente para cada grupo:

Campo Descrição
Coleta O nome da coleção na qual os dados são persistidos. Usado com o comando linkdetails
ID ID do Grupo que é exclusivo na coleção
Contagem Número de registros de log em um grupo. Nesta IU, você pode clicar neste campo para visualizar os registros de log. Você também pode usar Shift-Click para selecionar uma ou mais linhas na IU para exibir todos esses registros de log ou clusterizar os registros de log, usando as seguintes opções, respectivamente:
  • Clique em Mostrar, selecione Registros de Log
  • Clique em Mostrar, selecione Clusters
Horário de início Data/hora mais antiga de registros de log em um grupo
Horário de Término Data/hora mais recentes dos registros de log em um grupo
Duração do Grupo Tempo de duração dos registros de log em um grupo. Por padrão, este campo fica oculto na interface do usuário. Você pode mostrar esse campo clicando em Opções e selecionando a opção Ocultar/Mostrar Colunas.

Além disso, os campos a seguir também são produzidos para todos os grupos. Eles também ficam ocultos por padrão na IU e podem ser mostrados clicando em Opções e selecionando Ocultar/Mostrar Colunas:

Campo Descrição
Hora Inicial da Consulta Hora Inicial da consulta conforme selecionado usando o seletor de hora. Se você substituir o tempo especificando um intervalo de tempo explícito na consulta, ele será usado.
Hora Final da Consulta Hora Final da consulta conforme selecionado usando o seletor de hora. Se você substituir o tempo especificando um intervalo de tempo explícito na consulta, ele será usado.
Intervalo de Tendência O intervalo especificado no parâmetro span para o comando link. Este é o intervalo usado para timestats e outros gráficos. Se nenhuma span tiver sido especificada, um padrão será usado.
Unidade do Intervalo de Tendência A unidade do intervalo especificado no parâmetro span para o comando link.

Para obter exemplos de como usar esse comando em cenários típicos, consulte:

O seguinte comando agrupa todos os logs fatais por transação:

severity = fatal | link 'Transaction ID'

O seguinte comando agrupa todos os logs fatais por transação e obtém o tempo médio decorrido dos registros de log dentro de cada grupo:

severity = fatal | link 'Transaction ID' | stats avg('Elapsed Time (System)') as 'Average Elapsed Time'