Skip to content

Commit 1b6c767

Browse files
committed
refact: improving readability
1 parent aa8fb8f commit 1b6c767

File tree

1 file changed

+12
-15
lines changed

1 file changed

+12
-15
lines changed

content/pt-br/docs/concepts/cluster-administration/system-logs.md

Lines changed: 12 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,20 @@
11
---
2-
reviewers:
3-
- dims
4-
- 44past4
52
title: Logs de Sistema
63
content_type: concept
74
weight: 60
85
---
96

107
<!-- overview -->
118

12-
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)
9+
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).
1310

1411
<!-- body -->
1512

1613
## Klog
1714

1815
[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.
1916

20-
Para mais informações acerca da sua configuração, veja a documentação da [ferramenta de linha de comando](https://kubernetes.io/docs/reference/command-line-tools-reference/)
17+
Para mais informações acerca da sua configuração, veja a documentação da [ferramenta de linha de comando](https://kubernetes.io/docs/reference/command-line-tools-reference/).
2118

2219
Um exemplo do formato padrão dos logs da biblioteca:
2320
```
@@ -29,7 +26,7 @@ I1025 00:15:15.525108 1 httplog.go:79] GET /api/v1/namespaces/kube-system/
2926
{{< feature-state for_k8s_version="v1.19" state="alpha" >}}
3027

3128
{{< warning >}}
32-
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.
29+
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 processamento de arquivos de log, você também precisa lidar com logs não estruturados.
3330

3431
A formatação e serialização dos logs ainda estão sujeitas a alterações.
3532
{{< /warning>}}
@@ -54,9 +51,9 @@ I1025 00:15:15.525108 1 controller_utils.go:116] "Pod status updated" pod=
5451
{{< feature-state for_k8s_version="v1.19" state="alpha" >}}
5552

5653
{{<warning >}}
57-
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/).
54+
Algumas opções da biblioteca klog ainda não funcionam com 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/).
5855

59-
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
56+
Nem todos os logs estarão garantidamente em formato JSON (como por exemplo durante o início de processos). Sendo assim, se você pretende realizar o processamento dos logs, seu código deverá saber tratar também linhas que não são JSON.
6057

6158
O nome dos campos e a serialização JSON ainda estão sujeitos a mudanças.
6259
{{< /warning >}}
@@ -114,21 +111,21 @@ A opção `-v` controla o nível de detalhe dos logs. Um valor maior aumenta o n
114111

115112
### Localização dos Logs
116113

117-
Existem dois tipos de componentes do sistema: aqueles que são executados em um container e aqueles que não são. Por exemplo:
114+
Existem dois tipos de componentes do sistema: aqueles que são executados em um contêiner e aqueles que não são. Por exemplo:
118115

119-
* O [Kubernetes scheduler](https://kubernetes.io/pt-br/docs/concepts/overview/components/#kube-scheduler) e o [kube-proxy](https://kubernetes.io/pt-br/docs/concepts/overview/components/#kube-proxy) são executados em um container.
120-
* O [kubelet](https://kubernetes.io/pt-br/docs/concepts/overview/components/#kubelet) e o [container runtime](https://kubernetes.io/pt-br/docs/concepts/overview/components/#container-runtime), como o Docker por exemplo, não são executados em containers.
116+
* O [Kubernetes scheduler](https://kubernetes.io/pt-br/docs/concepts/overview/components/#kube-scheduler) e o [kube-proxy](https://kubernetes.io/pt-br/docs/concepts/overview/components/#kube-proxy) são executados em um contêiner.
117+
* O [kubelet](https://kubernetes.io/pt-br/docs/concepts/overview/components/#kubelet) e os [agentes de execução](https://kubernetes.io/pt-br/docs/concepts/overview/components/#container-runtime), como o Docker por exemplo, não são executados em contêineres.
121118

122-
Em máquinas com systemd, o kubelet e o container runtime gravam os logs no journald.
119+
Em máquinas com systemd, o kubelet e os agentes de execução gravam os logs no journald.
123120
Em outros casos, eles escrevem os logs em arquivos `.log` no diretório `/var/log`.
124-
Já os componentes executados dentro de containers, sempre irão escrever os logs em arquivos `.log`
121+
Já os componentes executados dentro de contêineres, sempre irão escrever os logs em arquivos `.log`
125122
no diretório `/var/log`, ignorando o mecanismo padrão de log.
126123

127-
De forma similar aos logs de container, os logs de componentes do sistema no diretório `/var/log` devem ser rotacionados.
124+
De forma similar aos logs de contêiner, os logs de componentes do sistema no diretório `/var/log` devem ser rotacionados.
128125
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
129126
ou quando o tamanho do arquivo excede 100MB.
130127

131-
## {{% heading "Próximos passos" %}}
128+
## {{% heading "whatsnext" %}}
132129

133130
* Leia sobre [Arquitetura de Logs do Kubernetes](/pt-br/docs/concepts/cluster-administration/logging/)
134131
* Leia sobre [Logs Estruturados](https://github.com/kubernetes/enhancements/tree/master/keps/sig-instrumentation/1602-structured-logging)

0 commit comments

Comments
 (0)