Consulte e veja registos

Depois de o coletor de registos extrair dados de vários componentes do projeto, a plataforma de observabilidade agrega registos de todas as origens de registos, adiciona índices e associa registos a etiquetas de acordo com a configuração da observabilidade de dados. Em seguida, pode consultar e ver os registos no painel de registos da instância de monitorização do sistema.

Consultar e ver registos no painel de registos

Pode consultar os registos através da interface do utilizador (IU) da instância do instância de monitorização do sistema do seu projeto. A instância de monitorização do sistema inclui medidas ao nível do projeto para monitorizar componentes da infraestrutura, como a utilização da CPU, o consumo de armazenamento, a monitorização da rede, a monitorização do servidor, os registos, os alertas e as métricas dos componentes do GDC.

Pode ver os registos no painel de registos da instância de monitorização do sistema do seu projeto. Em seguida, pode fazer consultas para ver registos específicos para a observabilidade de dados das necessidades do seu exemplo de utilização.

Antes de começar

Antes de consultar e ver registos no painel de registos, tem de obter acesso à instância de monitorização do sistema. Para mais informações, consulte o artigo Aceda aos painéis de controlo.

Para iniciar sessão e ver registos no Grafana, peça ao administrador de IAM do projeto que lhe conceda a função de visualizador do Grafana do projeto (project-grafana-viewer). Este processo de controlo de acesso baseado em funções permite-lhe aceder a visualizações de dados de forma segura.

Crie consultas para os seus registos

A consulta de registos a partir da IU da instância de monitorização do sistema permite-lhe escolher a origem de dados a partir da qual pretende obter registos operacionais do seu projeto e ter uma vista integrada das suas consultas. Para filtrar os resultados, pesquise registos por etiquetas através de expressões da linguagem de consulta. Por exemplo, pode definir as etiquetas cluster e namespace nas suas consultas para os valores que identificam o namespace do cluster e do projeto, respetivamente.

Ponto final da instância de monitorização do sistema

Para o operador de aplicações (AO)

O seguinte URL é o ponto final da instância de monitorização do seu projeto:

https://GDC_URL/PROJECT_NAMESPACE/grafana

Substitua o seguinte:

  • GDC_URL: o URL da sua organização no GDC.
  • PROJECT_NAMESPACE: o espaço de nomes do seu projeto.

Para o administrador da plataforma (PA)

O seguinte URL é o ponto final da instância de monitorização do seu projeto:

https://GDC_URL/platform-obs/grafana

Substitua GDC_URL pelo URL da sua organização no GDC.

Consultar registos operacionais

  1. Na consola do GDC, selecione um projeto.
  2. No menu de navegação, clique em Operações > Registo.

  3. Clique em Ver tudo no Grafana Loki.

    É aberta uma nova página com o URL da instância de monitorização do seu projeto.

  4. Na IU da instância de monitorização, clique em explorar Explorar no menu de navegação para abrir a página Explorar.

  5. No menu pendente na barra Explorar, selecione Registos operacionais como origem de dados para obter registos operacionais.

  6. Introduza uma consulta para pesquisar registos por etiquetas através de expressões LogQL (linguagem de consulta de registos). Pode concluir este passo de qualquer uma das seguintes formas:

    • Use a IU do criador de consultas interativo. Em seguida, clique em Executar consulta.
    • Introduza a consulta com expressões LogQL diretamente no campo de texto e prima Shift+Enter para executar a consulta.

    A página apresenta os registos que correspondem à sua consulta.

Depois de consultar os registos, pode exportá-los. Clique em Exportar para transferir registos em formatos de texto simples ou CSV.

A opção Registos operacionais está selecionada na página Explorar da IU para obter registos operacionais.

Figura 1. Opção de menu para consultar registos a partir da IU da instância de monitorização do sistema.

Na figura 1, a opção Registos operacionais apresenta a interface que lhe permite criar consultas de registos a partir da IU para obter registos operacionais.

Para consultar registos de auditoria em vez de registos operacionais, selecione Registos de auditoria como a origem de dados no menu pendente na barra Explorar no passo anterior.

A opção Registos de auditoria está selecionada na página Explorar da IU para obter registos de auditoria.

Figura 2. Opção de menu para consultar registos de auditoria a partir da IU da instância de monitorização.

Na figura 2, a opção Registos de auditoria apresenta a interface que lhe permite criar consultas a partir da IU para obter registos de auditoria.

Depois de consultar os registos, pode exportá-los. Clique no botão Exportar para transferir registos em formatos de texto simples ou CSV.

Conclua os passos seguintes para obter registos operacionais:

  1. Na consola do GDC, selecione um projeto.
  2. No menu de navegação, clique em Operações > Registo.

  3. Clique em Ver tudo no Grafana Loki.

    É aberta uma nova página com o URL da instância de monitorização do seu projeto.

  4. Na IU da instância de monitorização, clique em explorar Explorar no menu de navegação para abrir a página Explorar.

  5. No menu pendente na barra Explorar, selecione Registos operacionais como origem de dados para obter registos operacionais.

  6. Introduza uma consulta para pesquisar registos por etiquetas através de expressões LogQL (linguagem de consulta de registos). Pode concluir este passo de qualquer uma das seguintes formas:

    • Use a IU do criador de consultas interativo. Em seguida, clique em Executar consulta.
    • Introduza a consulta com expressões LogQL diretamente no campo de texto e prima Shift+Enter para executar a consulta.

    A página apresenta os registos que correspondem à sua consulta.

Depois de consultar os registos, pode exportá-los. Clique em Exportar para transferir registos em formatos de texto simples ou CSV.

Consultar registos de auditoria

Conclua os passos seguintes para obter registos de auditoria:

  1. Na consola do GDC, selecione um projeto.
  2. No menu de navegação, clique em Operações > Registo de auditoria.

  3. Clique em Ver tudo no Grafana Loki.

    É aberta uma nova página com o URL da instância de monitorização do seu projeto.

  4. Na IU da instância de monitorização, clique em explorar Explorar no menu de navegação para abrir a página Explorar.

  5. No menu pendente na barra Explorar, selecione Registos de auditoria como origem de dados para obter registos de auditoria.

  6. Introduza uma consulta para pesquisar registos por etiquetas através de expressões LogQL (linguagem de consulta de registos). Pode concluir este passo de qualquer uma das seguintes formas:

    • Use a IU do criador de consultas interativo. Em seguida, clique em Executar consulta.
    • Introduza a consulta com expressões LogQL diretamente no campo de texto e prima Shift+Enter para executar a consulta.

    A página apresenta os registos que correspondem à sua consulta.

Depois de consultar os registos, pode exportá-los. Clique em Exportar para transferir registos em formatos de texto simples ou CSV.

Selecione um intervalo de tempo para os seus registos

Para consultar registos num intervalo de tempo a partir da IU da instância de monitorização, siga estes passos:

  1. Clique no menu pendente Selecionador de horas.

  2. No menu, execute uma das seguintes ações:

    • Selecione opções de intervalo de tempo relativo, por exemplo, os últimos 30 minutos.
    • Defina intervalos de tempo absolutos personalizados escolhendo datas e horas específicas no calendário e clicando em Aplicar intervalo de tempo.

  3. Opcionalmente, clique em Alterar definições de hora para alterar as definições de Fuso horário e Ano fiscal nos controlos do intervalo de tempo.

As definições de tempo são guardadas por painel de controlo. Para mais informações sobre consultas num intervalo de tempo, consulte https://grafana.com/docs/loki/latest/reference/api/#query-loki-over-a-range-of-time.

Consultas e etiquetas de exemplo

Seguem-se algumas das etiquetas predefinidas que pode usar para consultar registos:

  • cluster: o nome do cluster
  • resources: a lista de recursos
  • namespace: o espaço de nomes do seu projeto
  • node: O prefixo do nome do nó
  • pod: o prefixo do nome do agrupamento
  • container: O prefixo do nome do contentor

A tabela seguinte descreve cada uma das etiquetas predefinidas que pode usar para consultar registos da plataforma de observabilidade:

Registar etiquetas
Tipo de registo Etiqueta Valor
Registos de contentores do Kubernetes cluster CLUSTER_NAME
resources k8s_container ou k8s_audit
namespace NAMESPACE_NAME
node NODE_NAME
pod POD_NAME
container CONTAINER_NAME
Outras etiquetas do Kubernetes
Registos journald de nós cluster CLUSTER_NAME
resources k8s_node
node NODE_NAME
identifier SYSLOG_IDENTIFIER
machine MACHINE_ID

As consultas usam a linguagem de consulta LogQL https://grafana.com/docs/loki/latest/logql/. Os exemplos de código seguintes mostram a utilização de etiquetas e valores para consultar diferentes registos:

  • Selecione todos os registos de um projeto:

    {cluster="user-vm-1-cluster", namespace="PROJECT_NAMESPACE"}

    Substitua PROJECT_NAMESPACE pelo espaço de nomes do seu projeto.

  • Selecione registos de projetos de um serviço:

    {cluster="user-vm-1-cluster", namespace="PROJECT_NAMESPACE", container="my-service"}

    Substitua PROJECT_NAMESPACE pelo espaço de nomes do seu projeto.

  • Selecione os registos do servidor da API Kubernetes:

    {cluster="admin", namespace="kube-system", resources="k8s_container", container="kube-apiserver"}

  • Selecione registos de arranque do cluster:

    {cluster="admin", namespace="PROJECT_NAMESPACE"}

    Substitua PROJECT_NAMESPACE pelo nome do espaço de nomes do seu projeto. Por exemplo, cluster-user-test.

  • Selecionar registos journald do nó:

    {cluster="admin", resources="k8s_node"}

  • Selecione os registos de auditoria do cluster:

    {cluster="admin", resources="k8s_audit"}