Skip to content

Commit 9b8e046

Browse files
committed
improving text readability
1 parent d50a1cd commit 9b8e046

File tree

1 file changed

+10
-11
lines changed

1 file changed

+10
-11
lines changed

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

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -9,14 +9,13 @@ weight: 60
99

1010
<!-- overview -->
1111

12-
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)
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)
1313

1414
<!-- body -->
1515

1616
## Klog
1717

1818
[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.
19-
generates log messages for the Kubernetes system components.
2019

2120
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/)
2221

@@ -30,12 +29,12 @@ I1025 00:15:15.525108 1 httplog.go:79] GET /api/v1/namespaces/kube-system/
3029
{{< feature-state for_k8s_version="v1.19" state="alpha" >}}
3130

3231
{{< warning >}}
33-
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.
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.
3433

3534
A formatação e serialização dos logs ainda estão sujeitas a alterações.
3635
{{< /warning>}}
3736

38-
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
37+
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.
3938

4039
Formato dos logs estruturados::
4140

@@ -55,14 +54,14 @@ I1025 00:15:15.525108 1 controller_utils.go:116] "Pod status updated" pod=
5554
{{< feature-state for_k8s_version="v1.19" state="alpha" >}}
5655

5756
{{<warning >}}
58-
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/).
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/).
5958

6059
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
6160

62-
O nome dos campos e a serialização JSON ainda está sujeita a mudanças.
61+
O nome dos campos e a serialização JSON ainda estão sujeitos a mudanças.
6362
{{< /warning >}}
6463

65-
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):
64+
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):
6665
```json
6766
{
6867
"ts": 1580306777.04728,
@@ -93,11 +92,11 @@ Lista dos componentes que suportam o formato JSON atualmente:
9392
{{< feature-state for_k8s_version="v1.20" state="alpha" >}}
9493

9594
{{<warning >}}
96-
A limpeza dos logs pode causar impactos significativos na performance, sendo portanto contraindicado em produção.
95+
A funcionalidade de limpeza dos logs pode causar impactos significativos na performance, sendo portanto contraindicada em produção.
9796
{{< /warning >}}
9897

9998
A opção `--experimental-logging-sanitization` habilita o filtro de limpeza dos logs.
100-
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.
99+
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.
101100

102101
Lista dos componentes que suportam a limpeza de logs atualmente:
103102
* {{< 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
111110

112111
### Nível de detalhe dos logs
113112

114-
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.
113+
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.
115114

116115
### Localização dos Logs
117116

@@ -126,7 +125,7 @@ Já os componentes executados dentro de containers, sempre irão escrever os log
126125
no diretório `/var/log`, ignorando o mecanismo padrão de log.
127126

128127
De forma similar aos logs de container, os logs de componentes do sistema no diretório `/var/log` devem ser rotacionados.
129-
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,
128+
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
130129
ou quando o tamanho do arquivo excede 100MB.
131130

132131
## {{% heading "Próximos passos" %}}

0 commit comments

Comments
 (0)