# 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).

---


Esta é a documentação do OpenTelemetry para a linguagem JavaScript. O
OpenTelemetry é um framework de observabilidade -- API, SDKs, e ferramentas que
são desenvolvidas para auxiliar na geração e coleta de dados de telemetria de
aplicações, como métricas, logs e rastros. Esta documentação foi criada para te
auxiliar a entender como começar a utilizar o OpenTelemetry em 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>
{{__hugo_ctx/}}



<div class="alert alert-warning" role="alert"><div class="h4 alert-heading" role="heading">Aviso</div>



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 Instrumentação do Cliente][sig].

[sig]:
  https://docs.google.com/document/d/16Vsdh-DM72AfMg_FIt9yT9ExEWF4A_vRbQ3jRNBe09w

</div>

{{__hugo_ctx/}}


## 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](/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
- [Propagation](/pt/docs/languages/js/propagation/): Context propagation for the JS SDK
- [Resources](/pt/docs/languages/js/resources/): Add details about your applications' environment to your telemetry
- [Sampling](/pt/docs/languages/js/sampling/): Reduce the amount of telemetry created
- [Serverless](/pt/docs/languages/js/serverless/): Instrument your serverless functions with OpenTelemetry JavaScript
- [Benchmarks](/pt/docs/languages/js/benchmarks/)
- [API reference](/pt/docs/languages/js/api/): Read the OpenTelemetry JavaScript API reference _(external page)_
- [Examples](/pt/docs/languages/js/examples/): Explore more examples for OpenTelemetry JavaScript _(external page)_
- [Registry](/pt/docs/languages/js/registry/): Instrumentation libraries, exporters and other useful components for OpenTelemetry JavaScript
