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 20 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 é o OpenTelemetry?
description:
Uma breve explicação sobre o que o OpenTelemetry é e não é.
weight: 150
default_lang_commit: f17277371622b97df4c15a6cfe3ce0b22e5538ef
---

O OpenTelemetry é um framework e um conjunto de
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/). Um aspecto crucial do OpenTelemetry é ser
agnóstico em relação a fornecedores e ferramentas, o que o possibilita ser
utilizado com uma grande variedade de backends de observabilidade,
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, gerenciamento e
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.
Crucialmente, o armazenamento e a visualização da telemetria são intencionalmente
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 o dados que ele emite.
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
requisitos de negócios cada vez mais complexos, a necessidade de
[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ê tem controle total sobre os dados que gera. Não há dependência de fornecedor
(_vendor lock-in_).
2. Você só precisa aprender um único conjunto de APIs e convenções.

Ambos os princípios combinados dão a flexibilidade que equipes e
organizações precisam no mundo da computação moderna atual.

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

## Os principais componentes do OpenTelemetry

O OpenTelemetry consiste dos seguintes componentes:

- Uma [especificação](/docs/specs/otel) para todos os componentes
- Um [protocolo](/docs/specs/otlp/) padrão que define o formato dos dados de
telemetria
- [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 definem como gerar dados de telemetria
- [SDKs para linguagens de programação](/docs/languages) que implementam a especificação, APIs e
exportação de dados de telemetria
- Um [ecossistema de bibliotecas](/ecosystem/registry) que implementa
instrumentação para bibliotecas e frameworks comuns
- Componentes para instrumentação automática que geram dados de telemetria sem
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
[recursos da comunidade para FaaS](/docs/faas/)

O OpenTelemetry é utilizado por diversas
[bibliotecas, serviços e aplicativos](/ecosystem/integrations/) que o integram
para fornecer observabilidade por padrão.

O OpenTelemetry é suportado por inúmeros [fornecedores](/ecosystem/vendors/),
muitos dos quais oferecem suporte comercial para o OpenTelemetry e contribuem
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 do OpenTelemetry (OTLP)
- Criar um propagador personalizado para formatos de propagação de contexto
não padronizados

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 da
[Cloud Native Computing Foundation (CNCF)](https://www.cncf.io) que é resultado
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 por completo de forma independente, eles se fundiram para formar o OpenTelemetry e
combinar seus esforços para oferecer uma solução única.

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

## Próximos passos

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