# JavaScript

> <img width="35" class="img-initial otel-icon" src="/img/logos/32x32/JS_SDK.svg" alt="JavaScript"> Implementação do OpenTelemetry específica em JavaScript (para Node.js & o navegador).

---

Site [llms.txt](/pt/llms.txt)

---

Boas-vindas à documentação do OpenTelemetry para JavaScript. Esta seção
apresenta como usar o OpenTelemetry com JavaScript para gerar e coletar dados
de telemetria, como métricas, logs e rastros, utilizando a API e os SDKs do
OpenTelemetry.

Estas páginas foram criadas para te ajudar a começar e a entender as capacidades
e o estado atuais do OpenTelemetry para JavaScript.

## Estado e Lançamentos {#status-and-releases}

O estado atual dos principais componentes funcionais do OpenTelemetry para
JavaScript é o seguinte:

| Rastros             | Métricas             | Logs              |
| ------------------- | -------------------- | ----------------- |
| [Stable](/docs/specs/otel/versioning-and-stability/#stable) | [Stable](/docs/specs/otel/versioning-and-stability/#stable) | [Development](/docs/specs/otel/versioning-and-stability/#development) |

Para lançamentos, incluindo a [última versão][latest release], consulte a página
de [Lançamentos][Releases]. 

[latest release]:
  <https://github.com/open-telemetry/opentelemetry-js/releases/latest>
[Releases]:
  <https://github.com/open-telemetry/opentelemetry-js/releases>



> [!WARNING]
>
> A instrumentação do cliente para o navegador é **experimental** e, em grande
> parte, **não está especificada**. Caso possua interesse em auxiliar, entre em
> contato com o [SIG de Navegador][Browser SIG].

[Browser SIG]: https://github.com/open-telemetry/opentelemetry-browser


## Suporte de Versões {#version-support}

O OpenTelemetry JavaScript oferece suporte a todas as versões do Node.js que
estejam em status LTS (_Long Term Support_) ativo ou de manutenção. Versões
anteriores do Node.js podem funcionar, mas não são testadas pelo OpenTelemetry.

O OpenTelemetry JavaScript não possui uma lista oficial de navegadores
suportados. O objetivo é funcionar nas versões atualmente suportadas dos
principais navegadores.

O OpenTelemetry JavaScript segue a política de suporte do _DefinitelyTyped_ para
TypeScript, que define uma janela de suporte de 2 anos. O suporte para versões
anteriores a 2 anos será removido em versões menores do OpenTelemetry
JavaScript.

Para mais detalhes sobre o suporte de tempo de execução, consulte
[esta visão geral](https://github.com/open-telemetry/opentelemetry-js#supported-runtimes).

## Repositórios {#repositories}

O OpenTelemetry JavaScript consiste nos seguintes repositórios:

- [opentelemetry-js](https://github.com/open-telemetry/opentelemetry-js),
  repositório principal que contém a API e o SDK de distribuição.
- [opentelemetry-js-contrib](https://github.com/open-telemetry/opentelemetry-js-contrib),
  repositório de contribuições que não fazem parte da distribuição central da
  API e SDK.

## Ajuda ou Feedback {#help-or-feedback}

Caso tenha alguma dúvida sobre o OpenTelemetry JavaScript, por favor, entre em
contato via
[GitHub Discussions](https://github.com/open-telemetry/opentelemetry-js/discussions)
ou através do canal `#otel-js` do [Slack do CNCF](https://slack.cncf.io/).

Se desejar contribuir para o OpenTelemetry JavaScript, veja as
[instruções de contribuição](https://github.com/open-telemetry/opentelemetry-js/blob/main/CONTRIBUTING.md)

---

Section pages:

- [Primeiros passos com exemplo](/pt/docs/languages/js/getting-started/): Comece a utilizar OpenTelemetry em Node.js e no navegador.
- [Instrumentação](/pt/docs/languages/js/instrumentation/): Instrumentação para OpenTelemetry JavaScript
- [Usando bibliotecas de instrumentação](/pt/docs/languages/js/libraries/): Como instrumentar bibliotecas das quais uma aplicação depende
- [Exporters](/pt/docs/languages/js/exporters/): Processe e exporte seus dados de telemetria
- [Contexto](/pt/docs/languages/js/context/): Documentação da API de Contexto do OpenTelemetry JavaScript
- [Propagação](/pt/docs/languages/js/propagation/): Propagação de contexto para o SDK JS
- [Recursos](/pt/docs/languages/js/resources/): Adicione detalhes sobre o ambiente das suas aplicações à sua telemetria
- [Amostragem](/pt/docs/languages/js/sampling/): Reduza a quantidade de telemetria criada
- [Serverless](/pt/docs/languages/js/serverless/): Instrumente suas funções serverless com OpenTelemetry JavaScript
- [Benchmarks](/pt/docs/languages/js/benchmarks/)
- [Referência da API](/pt/docs/languages/js/api/): Consulte a referência da API do OpenTelemetry JavaScript _(página externa)_
- [Exemplos](/pt/docs/languages/js/examples/): Explore mais exemplos para o OpenTelemetry JavaScript _(página externa)_
- [Registro](/pt/docs/languages/js/registry/): Bibliotecas de instrumentação, Exporters e outros componentes úteis para o OpenTelemetry JavaScript
