[pt] Add translations for /pt/docs/concepts/signals

content/pt/docs/concepts/signals/_index.md

@@ -0,0 +1,28 @@
+---
+title: Sinais
+description:
+  Aprenda sobre as categorias de telemetria suportadas pelo OpenTelemetry
+aliases:
+  - /docs/concepts/data-sources
+  - /docs/concepts/otel-concepts
+weight: 11
+default_lang_commit: 08e13eb62f2869300301670675969be705db59ae
+---
+
+O propósito do OpenTelemetry é coletar, processar e exportar **[sinais][]**.
+Sinais são saídas do sistema que descrevem a atividade subjacente do sistema
+operacional e das aplicações que estão sendo executadas em uma plataforma. Um
+sinal pode ser algo que você deseja medir em um momento específico, como a
+temperatura ou o uso de memória, ou um evento que passa pelos componentes do seu
+sistema distribuído e que você gostaria de rastrear. Você pode agrupar
+diferentes sinais para observar o funcionamento interno de uma mesma tecnologia
+sob diferentes ângulos.
+
+OpenTelemetry atualmente suporta [rastros](/docs/concepts/signals/traces),
+[métricas](/docs/concepts/signals/metrics), [logs](/docs/concepts/signals/logs)
+and [baggage](/docs/concepts/signals/baggage). _Eventos_ são um tipo específico
+de log, e o
+[_perfilamento_ está sendo trabalhado](https://github.com/open-telemetry/oteps/blob/main/text/profiles/0212-profiling-vision.md)
+pelo Grupo de Trabalho de Perfilamento (Profiling Working Group).
+
+[sinais]: /docs/specs/otel/glossary/#signals

content/pt/docs/concepts/signals/metrics.md

@@ -0,0 +1,128 @@
+---
+title: Métricas
+weight: 2
+description: Uma medição capturada em tempo de execução.
+default_lang_commit: 3446c7ce49a17975b012c302bdd1c89d4902267c
+---
+
+Uma **métrica** é uma **medição** de um serviço capturada em tempo de execução. O
+momento de captura desta medida é conhecido como **evento de métrica**, que
+consiste não apenas da medição por si só, mas também o tempo em que a captura
+foi feita e os metadados associados.
+
+Métricas de aplicação e de requisição são indicadores importantes de
+disponibilidade e desempenho. Métricas personalizadas podem fornecer insights
+sobre como os indicadores de disponibilidade impactam a experiência do usuário
+ou o negócio. Os dados coletados podem ser usados para alertar sobre uma
+interrupção ou desencadear decisões de escalonamento para aumentar
+automaticamente uma implantação em caso de alta demanda.
+
+Para entender como as métricas no OpenTelemetry funcionam, vamos analisar uma
+lista de componentes que farão parte da instrumentação do nosso código.
+
+## Meter Provider
+
+Um Meter Provider (às vezes chamado de `MeterProvider`) é uma fábrica de
+`Medidores`. Na maioria das aplicações, um Meter Provider é inicializado uma vez
+e seu ciclo de vida corresponde ao ciclo de vida da aplicação. A inicialização
+do Meter Provider também inclui a inicialização de Resource e Exporter. Esse é
+tipicamente o primeiro passo para metrificar com OpenTelemetry. Em alguns SDKs,
+um Meter Provider global já é inicializado para sua aplicação.
+
+## Medidor {#meter}
+
+Um Medidor cria [instrumentos de métrica](#metric-instruments), que serão
+responsáveis por capturar dados e medir um serviço em tempo de execução.
+Métricas são criadas a partir de Meter Providers (Medidores).
+
+## Metric Exporter
+
+Metric Exporters enviam dados de métricas para um consumidor. Esse consumidor
+pode ser a saída padrão para debugging durante o desenvolvimento, uma instância
+do OpenTelemetry Collector ou qualquer outro backend, seja de código aberto ou
+um vendor de sua escolha.
+
+## Metric Instruments
+
+Com o OpenTelemetry, as medições são capturadas através de **instrumentos de
+métrica**. Um instrumento de métrica é definido por:
+
+- Nome
+- Tipo
+- Unidade <em>(opcional)</em>
+- Descrição <em>(opcional)</em>
+
+O nome, unidade e descrição podem ser escolhidos pelo desenvolvedor ou definidos
+através da [convenção semântica](/docs/specs/semconv/general/metrics/) no caso
+de métricas comuns, como por exemplo métricas de requisições e processos.
+
+O tipo de instrumento deve ser um dos seguintes:
+
+- **Counter**: Um valor que acumula com o tempo -- você pode imaginar isso como
+  um odômetro de um carro; é um valor que só cresce.
+- **Asynchronous Counter**: Assim como o **Counter**, porém é coletado uma vez a
+  cada exportação. Pode ser usado em casos onde você não tenha acesso aos
+  incrementos contínuos, mas apenas ao valor agregado.
+- **UpDownCounter**: Um valor que acumula com o tempo, mas também pode cair. Um
+  exemplo seria o tamanho de uma fila, este valor irá aumentar e diminuir de
+  acordo com o número de itens que estão entrando ou saindo desta fila.
+- **Asynchronous UpDownCounter**: Assim como o **UpDownCounter**, porém é
+  coletado uma vez a cada exportação. Pode ser usado em casos onde você não
+  tenha acesso às mudanças contínuas, mas apenas ao valor agregado (ex., atual
+  tamanho da fila).
+- **Gauge**: Mede o valor atual no momento da leitura. Um exemplo seria um
+  medidor de tanque de combustível de um veículo. Gauges são assíncronos.
+- **Histogram**: Uma agregação de valores client-side, ta como latências de
+  requisições. Um histograma é uma boa escolha se você está interessado em
+  valores de estatísticas. Por exemplo: Quantas requisições estão levando menos
+  de 1s?
+
+Para visualizar mais instrumentos síncronos, assíncronos, e entender qual dos
+tipos melhor se encaixa no seu caso de uso, veja
+[Diretrizes Suplementares](/docs/specs/otel/metrics/supplementary-guidelines/).
+
+## Agregação {#aggregation}
+
+Em adicional aos instrumentos de métrica, também é importante entendermos o
+conceito de **agregações**. Uma agergação é uma teçnica pela qual um grande
+número de medições é combinado em estatísticas exatas ou estimadas sobre eventos
+de métricas que ocorreram durante uma janela de tempo. O protocolo OTLP
+transporta essas métricas agregadas. A API do OpenTelemetry fornece uma
+agregação padrão para cada instrumento, que podem ser sobrescritas com o uso de
+Views. Por padrão, o projeto OpenTelemetry visa fornecer agregações que sejam
+suportadas por diferentes visualizadores e backends de telemetria.
+
+Ao contrário dos [rastros](/docs/concepts/signals/traces/), que são destinados a
+capturar os ciclos de vida das requisições e fornecer o contexto para as partes
+individuais de uma requisição, as métricas são destinadas a fornecer informações
+estatísticas em forma de dados agregados. Alguns exemplos de caso de uso para as
+métricas incluem:
+
+- Reportar o número total de bytes lidos por um serviço, por tipo de protocolo.
+- Reportar o número total de bytes lidos e os bytes por requisição.
+- Reportar a duração de uma chamada de sistema.
+- Reportar tamanhos de requisições para determinar uma tendência.
+- Reportar o uso de CPU ou memória de um processo.
+- Reportar valores médios de saldo de uma conta.
+- Reportar o número atual de requisições ativas sendo processadas.
+
+## Views
+
+Uma view oferece aos usuários a flexibilidade de personalizar a saída das
+métricas fornecidas pelo SDK. Você pode personalizar quais instrumentos de
+métrica devem ser processados ou ignorados. Você também pode customizar a
+agregação e quais atributos deseja reportar em suas métricas.
+
+## Suporte de linguagens de programação {#language-support}
+
+As métricas são sinais
+[estáveis](/docs/specs/otel/versioning-and-stability/#stable) nas especificações
+do OpenTelemetry. Para uma implementação individual ou específica das Métricas
+através do SDK ou API, os status são os seguintes:
+
+{{% signal-support-table "metrics" %}}
+
+## Especificação {#specification}
+
+Para aprender mais sobre as métricas no OpenTelemetry, veja as
+[especificações de métricas](/docs/specs/otel/overview/#metric-signal).