As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Conecte-se a uma fonte de dados Loki
A fonte de dados Loki fornece acesso ao Loki, o sistema de agregação de registros da Grafana.
Adicionando a fonte de dados
-
Abra o espaço de trabalho da Grafana e verifique se você está logado.
-
No menu lateral, abaixo do link Configuração, você deve encontrar um link de Fontes de dados.
-
escolha o botão Adicionar fonte de dados na parte superior.
-
Selecione Loki na lista de fontes de dados.
nota
Se você não vê o link Fontes de dados no menu lateral, isso significa que seu usuário atual não tem a Admin função.
| Nome | Descrição |
|---|---|
Name
|
O nome da fonte de dados. É assim que você vê a fonte de dados em painéis, consultas e no Explore. |
Default
|
A fonte de dados padrão significa que ela será pré-selecionada para novos painéis. |
URL
|
O URL da instância do Loki; por exemplo,http://localhost:3100. Pode ser a URL de um host do Amazon EC2 ou de um Application Load Balancer na frente de um cluster do Amazon EKS ou qualquer outra URL de uma instância do Loki. |
Maximum lines
|
Limite superior para o número de linhas de registro retornadas pelo Loki (o padrão é 1000). Diminua se seu navegador estiver lento ao exibir registros no Explore. |
Campos derivados
Você pode usar a configuração de campos derivados para fazer o seguinte:
-
Adicione campos analisados a partir da mensagem de registro.
-
Adicione um link que use o valor do campo.
Você pode usar essa funcionalidade para vincular seu back-end de rastreamento diretamente de seus registros ou vincular a uma página de perfil de usuário se um ID de usuário estiver presente na linha de registro. Esses links aparecem nos detalhes do registro. Para ter mais informações, consulte Rótulos e campos detectados.
Cada campo derivado consiste no seguinte:
-
Nome — Mostrado nos detalhes do registro como um rótulo.
-
Regex — Um padrão Regex que é executado na mensagem de log e captura parte dela como o valor do novo campo. Só pode conter um único grupo de captura.
-
URL/consulta — Se o link for externo, insira o URL completo do link. Se o link for um link interno, essa entrada servirá como consulta para a fonte de dados de destino. Em ambos os casos, você pode interpolar o valor do campo com
${__value.raw }a macro. -
Link interno — Selecione se o link é interno ou externo. No caso de um link interno, um seletor de fonte de dados permite que você selecione a fonte de dados de destino. Somente fontes de dados de rastreamento são suportadas.
Você pode usar uma seção de depuração para ver o que seus campos extraem e como o URL é interpolado. Escolha Mostrar exemplo de mensagem de registro para mostrar a área de texto na qual você pode inserir uma mensagem de registro.
O novo campo com o link mostrado nos detalhes do registro.
Consultar os logs do
A consulta e a exibição de dados de registro do Loki estão disponíveis via Explore e com o painel de registros em visualizações. Selecione a fonte de dados Loki e, em seguida, insira uma consulta LogQL para exibir seus registros. Para obter mais informações sobre o LogQL, consulte LogQL
Registrar consultas
Uma consulta de log consiste em duas partes: seletor de fluxo de log e uma expressão de pesquisa. Por motivos de desempenho, você deve começar escolhendo um rótulo de log para um stream de log.
O Explorador de registros (o botão Rótulos de registros) ao lado do campo de consulta mostra uma lista de rótulos dos fluxos de registros disponíveis. Uma forma alternativa de escrever uma consulta é usar o preenchimento automático do campo de consulta. Você começa digitando uma chave ondulada esquerda { e o menu de preenchimento automático sugerirá uma lista de rótulos. Pressione a tecla Enter para executar a consulta.
Depois que o resultado é retornado, o painel de registro mostra uma lista de linhas de registro e um gráfico de barras em que o eixo x mostra a hora e o eixo y mostra a frequência/contagem.
Seletor de fluxo de log
Para a parte do rótulo da expressão de consulta, coloque-a em colchetes {} e use a sintaxe do valor-chave para selecionar rótulos. Várias expressões de rótulo são separadas por uma vírgula:
{app="mysql",name="mysql-backup"}
Atualmente, há suporte para os seguintes operadores de correspondência de rótulos:
-
=exatamente igual. -
!=não é igual. -
=~correspondência de regex. -
!~não faça correspondência regular.
Exemplos:
-
{name=~"mysql.+"} -
{name!~"mysql.+"}
Outra forma de adicionar um seletor de rótulos é na seção de tabela. Escolha Filtrar ao lado de um rótulo para adicionar o rótulo à expressão de consulta. Isso funciona até mesmo para várias consultas e adicionará o seletor de rótulos a cada consulta.
Expressões de pesquisa
Depois de escrever o Log Stream Selector, você pode filtrar ainda mais os resultados escrevendo uma expressão de pesquisa. A expressão de pesquisa pode ser apenas texto ou uma expressão regex.
Exemplos de consultas:
-
{job="mysql"} |= "error" -
{name="kafka"} |~ "tsdb-ops.*io:2003" -
{instance=~"kafka-[23]",name="kafka"} != "kafka.server:type=ReplicaManager"
Os operadores de filtro podem ser encadeados e filtrarão sequencialmente a expressão. As linhas de registro resultantes satisfarão todos os filtros.
Exemplo
{job="mysql"} |= "error" !=
"timeout"
Atualmente, há suporte para os seguintes tipos de filtro:
-
|=a linha contém uma string. -
!=a linha não contém string. -
|~a linha corresponde à expressão regular. -
!~a linha não corresponde à expressão regular.
nota
Para obter mais informações sobre LogQL, a linguagem de consulta de Loki, consulte Loki
Contexto do log
Ao usar uma expressão de pesquisa conforme detalhado acima, agora você tem a capacidade de recuperar o contexto em torno dos resultados filtrados. Ao escolher o Show Context link nas linhas filtradas, você poderá investigar as mensagens de registro que vieram antes e depois da mensagem de registro na qual você está interessado.
Modelagem
Em vez de codificar itens como nome do servidor, do aplicativo e do sensor em suas consultas métricas, você pode usar variáveis em seu lugar. As variáveis são mostradas como caixas de seleção suspensas na parte superior do painel. Você pode usar essas caixas suspensas para alterar os dados exibidos em seu painel.
Para obter mais informações sobre modelos e variáveis de modelo, consulteModelos e variáveis.
Anotações
Você pode usar qualquer consulta não métrica do Loki como fonte para anotações. O conteúdo do registro será usado como texto de anotação e os rótulos do seu fluxo de registros como tags, portanto, não há necessidade de mapeamento adicional.
