Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[pt] feat: add what is opentelemetry localization #4896

Merged
Merged
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
133 changes: 133 additions & 0 deletions content/pt/docs/what-is-opentelemetry.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,133 @@
---
title: O que é OpenTelemetry?
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
description:
Uma breve explicação sobre o que é o OpenTelemetry e o que ele não é.
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
weight: 150
default_lang_commit: f17277371622b97df4c15a6cfe3ce0b22e5538ef
---

O OpenTelemetry é uma estrutura de trabalho (_framework_) e um conjunto de
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
ferramentas de
[Observabilidade](/docs/concepts/observability-primer/#what-is-observability)
projetados para criar e gerenciar dados de telemetria como
[rastros](/docs/concepts/signals/traces/),
[métricas](/docs/concepts/signals/metrics/) e
[logs](/docs/concepts/signals/logs/). Essencialmente, o OpenTelemetry é
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
agnóstico em relação a fornecedores e ferramentas, o que significa que pode ser
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
utilizado com uma grande variedade de sistemas (_backends_) de observabilidade,
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
incluindo ferramentas de código aberto como
[Jaeger](https://www.jaegertracing.io/) e [Prometheus](https://prometheus.io/),
além de soluções comerciais.

O OpenTelemetry não é um backend de observabilidade como Jaeger, Prometheus ou
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
outra soluções comerciais. O OpenTelemetry é focado na geração, coleta e
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
exportação de telemetria. Um dos principais objetivos do OpenTelemetry é
permitir que você possa instrumentar suas aplicações ou sistemas de forma fácil,
independentemente da linguagem, infraestrutura ou ambiente de execução. Em
geral, o armazenamento e a visualização da telemetria são intencionalmente
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
deixados para outras ferramentas.

## O que é observabilidade?

[Observabilidade](/docs/concepts/observability-primer/#what-is-observability) é
a capacidade de entender o estado interno de um sistema ao examinar suas saídas.
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
No contexto de software, isso significa ser capaz de entender o estado interno
do sistema analisando seus dados de telemetria, que incluem rastros, métricas e
logs.

Para tornar um sistema observável, ele deve ser
[instrumentado](/docs/concepts/instrumentation). Ou seja, o código deve emitir
[rastros](/docs/concepts/signals/traces/),
[métricas](/docs/concepts/signals/metrics/) ou
[logs](/docs/concepts/signals/logs/). Os dados instrumentados devem então ser
enviados para um backend de observabilidade.

## Por que OpenTelemetry?

Com a ascensão da computação em nuvem, arquiteturas de microsserviços e dos
requisitos de negócios cada vez mais complexos, a necessidade de
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
[observabilidade](/docs/concepts/observability-primer/#what-is-observability) de
software e infraestrutura é cada vez maior.

O OpenTelemetry atende à necessidade de observabilidade seguindo dois
princípios-chave:

1. Você é o proprietário dos dados que gera. Não há dependência de fornecedor
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
(_lock-in_).
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
2. Você só precisa aprender um único conjunto de APIs e convenções.

Ambos os princípios combinados concedem às equipes e organizações a
flexibilidade de que precisam no mundo da computação moderna de hoje.
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved

Se você quiser saber mais, dê uma olhada na
[missão, visão e valores](/community/mission/) do OpenTelemetry.

## Os principais componentes do OpenTelemetry

OpenTelemetry consiste dos seguintes componentes:
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved

- Uma [especificação](/docs/specs/otel) para todos os componentes
- Um [protocolo](/docs/specs/otlp/) padrão que defini a forma dos dados de
telemetria
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
- [Convenções semânticas](/docs/specs/semconv/) que estabelecem um padrão de
nomenclatura para tipos comuns de dados de telemetria.
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
- APIs que define como gerar dados de telemetria
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
- [SDKs de linguagem](/docs/languages) que implementam a especificação, APIs e
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
exportação de dados de telemetria
- Um [ecossistema de bibliotecas](/ecosystem/registry) que implementa
instrumentação para bibliotecas e estruturas de trabalho comuns
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Comuns" aqui parece que está falando meio que do "valor" das bibliotecas e frameworks.

Suggested change
instrumentação para bibliotecas e estruturas de trabalho comuns
instrumentação para bibliotecas e estruturas de trabalho comumente utilizados

- Componentes de instrumentação automática que geram dados de telemetria sem
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
exigir alterações no código
- O [OpenTelemetry Collector](/docs/collector), é um intermediário (_proxy_) que
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- O [OpenTelemetry Collector](/docs/collector), é um intermediário (_proxy_) que
- O [OpenTelemetry Collector](/docs/collector), um _proxy_ intermediário que

Acho que proxy entra na mesma categoria de framework e backend?

Copy link
Contributor Author

@EzzioMoreira EzzioMoreira Aug 1, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Estamos conversando sobre isso deixar as palavras não traduzidas em italico no slack: https://cloud-native.slack.com/archives/C076LET8YSK/p1722081172868059

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@lgfa29 podemos remover a palavra intermediário e deixar apenas proxy sem tradução, essa palavra é bem difundida na área.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Legal, pode ser também. Eu não tinha notado que o "intermediário" seria uma tradução de proxy.

recebe, processa e exporta dados de telemetria
- Várias outras ferramentas, como o
[OpenTelemetry Operador para Kubernetes](/docs/kubernetes/operator/),
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
[OpenTelemetry Helm Charts](/docs/kubernetes/helm/), e
[comunidade ativa para FaaS](/docs/faas/)
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved

O OpenTelemetry é utilizado por uma grande variedade de
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
[bibliotecas, serviços e aplicativos](/ecosystem/integrations/) que o integram
para fornecer um padrão de observabilidade.
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved

OpenTelemetry é suportado por inúmeros [fornecedores](/ecosystem/vendors/),
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
muitos dos quais oferecem suporte comercial para OpenTelemetry e contribuem
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
diretamente para o projeto.

## Extensibilidade

O OpenTelemetry é projetado para ser extensível. Alguns exemplos de como ele
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
pode ser estendido incluem:

- Adicionar um receptor ao OpenTelemetry Collector para suportar dados de
telemetria de uma fonte personalizada
- Carregar bibliotecas de instrumentação personalizadas em um SDK
- Criar uma [distribuição](/docs/concepts/distributions/) de um SDK ou do
Collector adaptada a um caso de uso específico
- Criar um novo exportador para um backend personalizado que ainda não suporta o
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
protocolo OpenTelemetry (OTLP)
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
- Criar um propagador personalizado para um formato de propagação de contexto
não padrão
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved

Embora a maioria dos usuários possa não precisar estender o OpenTelemetry, o
projeto é projetado para tornar isso possível em quase todos os níveis.

## História

O OpenTelemetry é um projeto
[Cloud Native Computing Foundation (CNCF)](https://www.cncf.io) que é resultado
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
da fusão entre dois projetos anteriores, [OpenTracing](https://opentracing.io)
and [OpenCensus](https://opencensus.io).
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved

Ambos os projetos foram criados para resolver o mesmo problema: a falta de um
padrão de como instrumentar o código e enviar dados de telemetria para um
backend de Observabilidade. Como nenhum dos projetos conseguiu resolver o
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved
problema de forma independente, eles se fundiram para formar o OpenTelemetry e
combinar seus esforços, oferecendo uma solução única.
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved

Se você está atualmente utilizando OpenTracing ou OpenCensus, pode aprender como
migrar para o OpenTelemetry no [guia de migração](/docs/migration/).

## O que vem a seguir?
EzzioMoreira marked this conversation as resolved.
Show resolved Hide resolved

- [Começando](/docs/getting-started/) — mergulhe de cabeça!
- Aprenda sobre os [conceitos do OpenTelemetry](/docs/concepts/).
Loading