[pt] Add content/pt/docs/concepts/instrumentation/code-based.md

content/pt/docs/concepts/instrumentation/code-based.md

@@ -0,0 +1,70 @@
+---
+title: Baseada em código
+description:
+  Informe-se sobre as etapas essenciais na configuração da instrumentação
+  baseada em código
+weight: 20
+aliases: [manual]
+default_lang_commit: fe0c3f68902aeb6e7584ffc32c6c8964d7a89e6e
+---
+
+## Importar a API e o SDK do OpenTelemetry
+
+Primeiro, você precisará importar o OpenTelemetry para o seu código. Se estiver
+desenvolvendo uma biblioteca ou algum outro componente que se destina a ser
+consumido por um binário executável, você só dependeria da API. Se o seu
+artefato for um processo ou serviço independente, então você dependeria da API e
+do SDK. Para obter mais informações sobre a API e o SDK do OpenTelemetry,
+consulte a [especificação](/docs/specs/otel/).
+
+## Configurar a API do OpenTelemetry
+
+Para criar rastros ou métricas, primeiro você precisa criar um provider tracer
+e/ou meter. Geralmente, recomendamos que o SDK forneça um único provider padrão
+para esses objetos. Em seguida, você obtem uma instância tracer ou meter desse
+provider e atribui a ela um nome e uma versão. O nome que você escolher aqui
+deve identificar exatamente o que está sendo instrumentado - se você está
+desenvolvendo uma biblioteca, por exemplo, você deve nomeá-la com o nome da sua
+biblioteca (por exemplo `com.example.myLibrary`), pois esse nome será usado como
+namespace todos os eventos de trecho ou métricas que for produzidos. Além disso,
+é recomendável fornecer uma string de versão (ou seja, `semver:1.0.0`) que
+corresponda à versão atual da sua biblioteca ou serviço.
+
+## Configurar o SDK do OpenTelemetry
+
+Se você está desenvolvendo um processo de serviço, também precisará configurar o
+SDK com as opções adequadas para exportar seus dados de telemetria para um
+backend de análise. Recomendamos que esta configuração seja feita
+programaticamente por meio de um arquivo de configuração ou outro mecanismo.
+Além disso, existem opções de ajuste específicas para cada linguagem de
+programação que você pode utilizar.
+
+## Criar dados de telemetria
+
+Depois de configurar a API e o SDK, você estará livre para criar eventos de
+rastro e métricas usando os objetos tracer e meter obtidos do provider. Utilize
+bibliotecas de instrumentação para suas dependências -- confira o
+[registry](/ecosystem/registry/) ou o repositório da sua linguagem de
+programação para mais informações sobre essas bibliotecas.
+
+## Exportar dados
+
+Depois de criar os dados de telemetria, você vai querer enviá-los para algum
+lugar. OpenTelemetry oferece suporte a dois métodos principais de exportação de
+dados do seu processo para um backend de análise, diretamente de um processo ou
+através de um proxy através do [OpenTelemetry Collector](/docs/collector).
+
+A exportação em processo exige que você importe e dependa de um ou mais
+_exporters_, bibliotecas responsáveis por traduzir os objetos de trechos e
+métricas em memória do OpenTelemetry para o formato apropriado para ferramentas
+de análise de telemetria, como Jaeger ou Prometheus. Além disso, o OpenTelemetry
+suporta um protocolo conhecido como `OTLP`, que é compatível com todos os SDKs
+do OpenTelemetry. Esse protocolo pode ser utilizado para enviar dados ao
+OpenTelemetry Collector, um processo binário que pode ser executado como proxy,
+sidecar ou em um host separado. O Collector pode então ser configurado para
+encaminhar e exportar esses dados para ferramentas de análise de sua escolha.
+
+Além das ferramentas open source como Jaeger ou Prometheus, uma lista crescente
+de empresas oferece suporte para ingestão de dados de telemetria do
+OpenTelemetry. Para mais detalhes, consulte os
+[Fornecedores](/ecosystem/vendors/).