improving text readability
MarcosN
parent
d50a1cd890
commit
9b8e046000
|
|
@ -9,14 +9,13 @@ weight: 60
|
|||
|
||||
<!-- overview -->
|
||||
|
||||
Logs de componentes do sistema armazenam eventos que acontecem no cluster, tornando-os muito úteis para depuração. Seu nível de detalhe pode ser ajustado para mais ou para menos. Podendo se ater por exemplo a mostrar apenas os erros que ocorrem no componente, ou chegar a mostrar cada passo de um evento. (Como acessos HTTP, mudanças no estado dos pods, ações dos controllers, ou decisões do scheduler)
|
||||
Logs de componentes do sistema armazenam eventos que acontecem no cluster, sendo muito úteis para depuração. Seus níveis de detalhe podem ser ajustados para mais ou para menos. Podendo se ater, por exemplo, a mostrar apenas os erros que ocorrem no componente, ou chegando a mostrar cada passo de um evento. (Como acessos HTTP, mudanças no estado dos pods, ações dos controllers, ou decisões do scheduler)
|
||||
|
||||
<!-- body -->
|
||||
|
||||
## Klog
|
||||
|
||||
[Klog](https://github.com/kubernetes/klog) é a biblioteca de logs do Kubernetes. Responsável por gerar as mensagens de log para os componentes do sistema.
|
||||
generates log messages for the Kubernetes system components.
|
||||
|
||||
Para mais informações acerca da sua configruação, veja a documentação da [ferramenta de linha de comando](https://kubernetes.io/docs/reference/command-line-tools-reference/)
|
||||
|
||||
|
|
@ -30,12 +29,12 @@ I1025 00:15:15.525108 1 httplog.go:79] GET /api/v1/namespaces/kube-system/
|
|||
{{< feature-state for_k8s_version="v1.19" state="alpha" >}}
|
||||
|
||||
{{< warning >}}
|
||||
A migração pro formato de logs estruturados é um processo em andamento. Nem todos os logs estão dessa forma na versão atual. Dessa forma, para realizar o parsing de arquivos de log, você também precisa lidar com logs não estruturados.
|
||||
A migração pro formato de logs estruturados é um processo em andamento. Nem todos os logs estão dessa forma na versão atual. Sendo assim, para realizar o parsing de arquivos de log, você também precisa lidar com logs não estruturados.
|
||||
|
||||
A formatação e serialização dos logs ainda estão sujeitas a alterações.
|
||||
{{< /warning>}}
|
||||
|
||||
A estruturação dos logs trás uma estrutura uniforme para as mensagens de log, facilitando a extração programacional de informações. Logs estruturados podem ser armazenados e processados com menos esforço e custo. Esse formato é totalmente retrocompatível e é habilitado por padrão
|
||||
A estruturação dos logs trás uma estrutura uniforme para as mensagens de log, facilitando a extração programacional de informações. Logs estruturados podem ser armazenados e processados com menos esforço e custo. Esse formato é totalmente retrocompatível e é habilitado por padrão.
|
||||
|
||||
Formato dos logs estruturados::
|
||||
|
||||
|
|
@ -55,14 +54,14 @@ I1025 00:15:15.525108 1 controller_utils.go:116] "Pod status updated" pod=
|
|||
{{< feature-state for_k8s_version="v1.19" state="alpha" >}}
|
||||
|
||||
{{<warning >}}
|
||||
Algumas opções da biblioteca klog ainda não funcionam com o os logs em formato JSON. Para ver uma lista completa de quais são, veja a documentação da [ferramenta de linha de comando](/docs/reference/command-line-tools-reference/).
|
||||
Algumas opções da biblioteca klog ainda não funcionam com o os logs em formato JSON. Para ver uma lista completa de quais são estas, veja a documentação da [ferramenta de linha de comando](/docs/reference/command-line-tools-reference/).
|
||||
|
||||
Nem todos os logs estarão garantidamente em formato JSON (como por exemplo durante o início de processos). Se você pretender realizar um parsing dos logs, seu código deverá saber tratar também linhas que não são JSON
|
||||
|
||||
O nome dos campos e a serialização JSON ainda está sujeita a mudanças.
|
||||
O nome dos campos e a serialização JSON ainda estão sujeitos a mudanças.
|
||||
{{< /warning >}}
|
||||
|
||||
A opção `--logging-format=json` muda o formato dos logs do formato padrão da klog para JSON. Abaixo segue um exemplo de um log em formato JSON (identado):
|
||||
A opção `--logging-format=json` muda o formato dos logs, do formato padrão da klog para JSON. Abaixo segue um exemplo de um log em formato JSON (identado):
|
||||
```json
|
||||
{
|
||||
"ts": 1580306777.04728,
|
||||
|
|
@ -93,11 +92,11 @@ Lista dos componentes que suportam o formato JSON atualmente:
|
|||
{{< feature-state for_k8s_version="v1.20" state="alpha" >}}
|
||||
|
||||
{{<warning >}}
|
||||
A limpeza dos logs pode causar impactos significativos na performance, sendo portanto contraindicado em produção.
|
||||
A funcionalidade de limpeza dos logs pode causar impactos significativos na performance, sendo portanto contraindicada em produção.
|
||||
{{< /warning >}}
|
||||
|
||||
A opção `--experimental-logging-sanitization` habilita o filtro de limpeza dos logs.
|
||||
Quando habilitado, esse filtro inspeciona todos os argumentos dos logs procurando por campos contendo dados sensíveis (como senhas, chaves e tokens). Tais campos não serão expostos nas mensagens de log.
|
||||
Quando habilitado, esse filtro inspeciona todos os argumentos dos logs, procurando por campos contendo dados sensíveis (como senhas, chaves e tokens). Tais campos não serão expostos nas mensagens de log.
|
||||
|
||||
Lista dos componentes que suportam a limpeza de logs atualmente:
|
||||
* {{< glossary_tooltip term_id="kube-controller-manager" text="kube-controller-manager" >}}
|
||||
|
|
@ -111,7 +110,7 @@ O filtro de limpeza dos logs não impede a exposição de dados sensíveis nos l
|
|||
|
||||
### Nível de detalhe dos logs
|
||||
|
||||
A opção `-v` controla o nível de detalhe dos logs. Um valor maior aumenta o número de eventos registrados, começando a registrar também os eventos menos importantes. Um valor menor restringe os logs apenas aos eventos mais importantes. O valor padrão 0 registra apenas eventos críticos.
|
||||
A opção `-v` controla o nível de detalhe dos logs. Um valor maior aumenta o número de eventos registrados, começando a registrar também os eventos menos importantes. Similarmente, um valor menor restringe os logs apenas aos eventos mais importantes. O valor padrão 0 registra apenas eventos críticos.
|
||||
|
||||
### Localização dos Logs
|
||||
|
||||
|
|
@ -126,7 +125,7 @@ Já os componentes executados dentro de containers, sempre irão escrever os log
|
|||
no diretório `/var/log`, ignorando o mecanismo padrão de log.
|
||||
|
||||
De forma similar aos logs de container, os logs de componentes do sistema no diretório `/var/log` devem ser rotacionados.
|
||||
Nos clusters Kubernetes criados com o script `kube-up.sh`, a rotação dos logs é configurada pela ferramenta `logrotate`. Essa ferramenta rotaciona os logs diariamente,
|
||||
Nos clusters Kubernetes criados com o script `kube-up.sh`, a rotação dos logs é configurada pela ferramenta `logrotate`. Essa ferramenta rotaciona os logs diariamente
|
||||
ou quando o tamanho do arquivo excede 100MB.
|
||||
|
||||
## {{% heading "Próximos passos" %}}
|
||||
|
|
|
|||
Loading…
Reference in New Issue