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] Add translations for /pt/docs/concepts/distributions.md #5125

Merged
Merged
Changes from 11 commits
Commits
Show all changes
37 commits
Select commit Hold shift + click to select a range
0034088
Add translations for /pt/docs/concepts/distributions.md
vitorvasc Aug 29, 2024
cc8a339
Merge branch 'main' into pt_translate_concepts_distributions
vitorvasc Aug 29, 2024
7046204
Fix translation for Collector
vitorvasc Aug 29, 2024
c3d3fbb
Format english terms as italic
vitorvasc Aug 30, 2024
3e5aff2
Merge branch 'main' into pt_translate_concepts_distributions
vitorvasc Aug 30, 2024
4a55369
Merge branch 'main' into pt_translate_concepts_distributions
vitorvasc Sep 2, 2024
a8473a7
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 3, 2024
a8ad146
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 3, 2024
39889c3
Fix how we refer to the OpenTelemetry project
vitorvasc Sep 3, 2024
4e20c65
Fix, rollback translations on how we mention upstream and Registry
vitorvasc Sep 3, 2024
3c2babf
Run linter
vitorvasc Sep 3, 2024
cd47afa
Merge branch 'main' into pt_translate_concepts_distributions
vitorvasc Sep 3, 2024
854957b
Fix typo
vitorvasc Sep 3, 2024
262d5d3
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
59ea0b5
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
17d53ab
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
23ac9fd
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
a2d4767
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
b0cb061
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
dc852ad
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
35f912a
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
f0988f7
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
e4d0ad3
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
c4dded4
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
eb4b403
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
7ea9537
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
1dcdae7
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
3f544cb
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
029e7ef
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
df6e509
Updated as suggested
vitorvasc Sep 5, 2024
b5c2818
Merge branch 'main' into pt_translate_concepts_distributions
vitorvasc Sep 5, 2024
85e7f23
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
13b16d1
Results from /fix:all
opentelemetrybot Sep 5, 2024
9e81dc3
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 6, 2024
9b1bda8
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 6, 2024
e717131
Results from /fix:all
opentelemetrybot Sep 6, 2024
a389c5d
Merge branch 'main' into pt_translate_concepts_distributions
theletterf Sep 8, 2024
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
117 changes: 117 additions & 0 deletions content/pt/docs/concepts/distributions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,117 @@
---
title: Distribuições
description: >-
Uma distribuição, que não deve ser confundida com um fork, é uma versão
customizada de um componente do OpenTelemetry.
weight: 190
default_lang_commit: 2f34c456ab38b4d3502cd07bc36fa1455d4ef875
---

Os projetos do OpenTelemetry consistem em múltiplos [componentes](../components)
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved
que suportam múltiplos [sinais](../signals). As implementações de referência do
OpenTelemetry estão disponíveis em:

- [Bibliotecas de instrumentação específicas para linguagens de programação](../instrumentation)
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved
- Um [Collector binário](/docs/concepts/components/#collector)
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved

Qualquer implementação de referência pode ser personalizada como uma
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved
distribuição.

## O que é uma distribuição? {#what-is-a-distribution}

Uma distribuição é uma versão personalizada de um componente do OpenTelemetry.
Uma distribuição é um encapsulamento em torno de um repositório do OpenTelemetry
com algumas personalizações. Distribuições não devem ser confundidas com
_forks_.

As personalizações em uma distribuição podem incluir:

- Scripts para facilitar ou personalizar o uso de um backend ou fornecedor
específico
- Alterações nas configurações padrão, necessárias para um backend, fornecedor
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved
ou usário final

Check warning on line 32 in content/pt/docs/concepts/distributions.md

View workflow job for this annotation

GitHub Actions / SPELLING check

Unknown word (usário) Suggestions: (suário, unário, uvário, usuário, unario)
- Pacotes ou bibliotecas adicionais que podem ser específicas para determinado
fornecedor ou usuário final
- Cobertura adicional de testes, performance e segurança além do fornecido pelo
OpenTelemetry
- Funcionalidades adicionais além do que já é fornecido pelo OpenTelemetry
- Remoção de funcionalidades fornecidas pelo OpenTelemetry

As distribuições geralmente se enquadram nas seguintes categorias:

- **"Pura":** Estas distribuições fornecem as mesmas funcionalidades da versão
pública e são 100% compatíveis. As personalizações normalmente aprimoram a
facilidade de uso ou configurações. Estas personalizações podem ser
específicas para backends, fornecedores ou usuários finais.
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved
- **"Plus":** Estas distribuições oferecem funcionalidades adicionais ao que é
encontrado na upstream, através de componentes adicionais. Exemplos incluem
bibliotecas de instrumentação ou exportadores de fornecedores que não foram
incluídos na upstream do OpenTelemetry.
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved
- **"Minus":** Estas distribuições fornecem um subconjunto de funcionalidades da
upstream. Exemplos podem incluir a remoção de bibliotecas de instrumentação ou
de receptores, processadores, exportadores ou extensões encontradas no projeto
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved
do OpenTelemetry Collector. Estas distribuições podem ser fornecidas para
aumentar o suporte e/ou temas relacionados à segurança.
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved

## Quem pode criar uma distribuição? {#who-can-create-a-distribution}

Qualquer pessoa pode criar uma distribuição. Atualmente, diversos
[fornecedores](/ecosystem/vendors/) oferecem
[distribuições](/ecosystem/distributions). Além disso, os usuários finais podem
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved
considerar criar uma distribuição caso queiram usar componentes no
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved
[Registry](/ecosystem/registry) que não foram incluídos na upstream do projeto
emdneto marked this conversation as resolved.
Show resolved Hide resolved
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved
do OpenTelemetry.

## Contribuição ou distribuição? {#contribution-or-distribution}

Antes de continuar e aprender como criar sua própria distribuição, pergunte a si
mesmo se as suas adições a um determinado componente do OpenTelemetry seriam
benéficas para todos e, portanto, deveriam ser incluídas nas implementações de
referência:

- Os seus scripts são "fáceis para uso" e podem ser generalizados?
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved
- Suas alterações nas configurações padrão podem ser a melhor opção para todos?
- Os seus pacotes ou bibliotecas adicionais, são realmente específicos?
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved
- Sua cobertura de testes, performance ou segurança também funcionarão nas
implementações de referência?
- Você verificou com a comunidade se as suas funcionalidades ou comportamentos
adicionais podem se tornar parte do padrão?

## Criando a sua própria distribuição {#creating-your-own-distribution}

### Collector

Um guia sobre como criar a sua própria distribuição está disponível nesta
publicação do blog:
["Building your own OpenTelemetry Collector distribution"](https://medium.com/p/42337e994b63)

Caso você esteja criando a sua própria distribuição, o
[OpenTelemetry Collector Builder](https://github.com/open-telemetry/opentelemetry-collector/tree/main/cmd/builder)
pode ser um bom ponto de partida.

### Bibliotecas de instrumentação específicas para linguagens de programação {#language-specific-instrumentation-libraries}
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved

Existem algumas linguagens de programação que exigem mecanismos de
extensibilidade específicos para a personalização das bibliotecas de
instrumentação:

- [Java agent](/docs/zero-code/java/agent/extensions)

## Siga as diretrizes {#follow-the-guidelines}

Ao utilizar materiais relacionados ao projeto do OpenTelemetry para
distribuição, como logotipo e nome, certifique-se de estar alinhado com as
[Diretrizes de Marketing do OpenTelemetry para Organizações
Contribuintes][diretrizes] .
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved

O projeto do OpenTelemetry não certifica distribuições neste momento. No futuro,
o OpenTelemetry poderá certificar distribuições e parceiros de maneira
semelhante ao que ocorre no projeto Kubernetes. Ao avaliar uma distribuição,
assegure-se de que seu uso não irá resultar em uma dependência de fornecedor
(vendor lock-in).
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved

> Qualquer suporte para uma distribuição deve ser fornecido diretamente pelos
> seus autores e não por autores do projeto do OpenTelemetry.
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved

[diretrizes]:
https://github.com/open-telemetry/community/blob/main/marketing-guidelines.md
Loading