From e0a8f021d3f6e0c30af7e38203d59a481ce0382f Mon Sep 17 00:00:00 2001 From: Cassio Moreira Date: Tue, 3 Sep 2024 22:01:34 +0100 Subject: [PATCH] =?UTF-8?q?[pt-br]=20Tradu=C3=A7=C3=A3o=20de=20metricas=20?= =?UTF-8?q?para=20Porgugues=20Brasil?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- content/pt/docs/concepts/signals/metrics.md | 126 ++++++++++++++++++++ 1 file changed, 126 insertions(+) create mode 100644 content/pt/docs/concepts/signals/metrics.md diff --git a/content/pt/docs/concepts/signals/metrics.md b/content/pt/docs/concepts/signals/metrics.md new file mode 100644 index 000000000000..ac204b7d6544 --- /dev/null +++ b/content/pt/docs/concepts/signals/metrics.md @@ -0,0 +1,126 @@ +--- +title: Métricas +weight: 2 +description: Uma medição capturada em tempo de execução. +default_lang_commit: 09f39d1aef5d792a68be42746a06ac828a499350 +--- + +Uma **métrica** é uma **medição** de um serviço em tempo de execução. O momento +de captura dessas medições é conhecido como **evento de métrica**, que consiste +não apenas na medição em si, mas também no momento em que ela foi capturada e os +metadados associados. + +Métricas de aplicação e solicitação são indicadores importantes de +disponibilidade e desempenho. Métricas personalizadas podem fornecer percepções +sobre como os indicadores de disponibilidade impactam a experiência do usuário +ou o negócio. Dados coletados podem ser usados para alertar sobre uma +interrupção ou acionar decisões de agendamento para escalar uma aplicação +automaticamente mediante alta demanda. + +Para entender como as métricas no OpenTelemetry funcionam, vamos dar uma olhada +em uma lista de componentes que desempenharão um papel na instrumentação do +nosso código. + +## Meter Provider + +Um Meter Provider (às vezes chamado de `MeterProvider`) é uma fábrica para +`Meter`s (Medidas). Na maioria dos aplicativos, um Meter Provider é inicializado +uma vez e seu ciclo de vida corresponde ao ciclo de vida do aplicativo. A +inicialização do Meter Provider também inclui a inicialização do Resource e do +Exporter. Normalmente, é o primeiro passo na medição com OpenTelemetry. Em +alguns SDKs, um Meter Provider global já está inicializado para você. + +## Meter + +Um Meter cria [instrumentos metricos](#metric-instruments), capturando medições +sobre um serviço em tempo de execução. Os Meters são criados a partir de Meter +Providers. + +## Metric Exporter + +Exportadores de Métricas enviam dados de métricas para um consumidor. Este +consumidor pode ser saída padrão para depuração durante o desenvolvimento, o +OpenTelemetry Collector ou qualquer backend de código aberto, ou fornecedor de +sua escolha. + +## Metric Instruments + +No OpenTelemetry as medições são capturadas por **instrumentos métricos**. Um +instrumento métrico é definido por: + +- Nome +- Tipo +- Unidade (opcional) +- Descrição (opcional) + +O nome, a unidade e a descrição são escolhidos pelo desenvolvedor ou definidos +via [convenções semânticas](/docs/specs/semconv/general/metrics/) para as mais +comuns como métricas de solicitação e processo. + +O tipo de instrumento pode ser um dos seguintes: + +- **Counter**: Um valor que se acumula ao longo do tempo -- você pode pensar + nisso como um odômetro em um carro; ele só sobe. +- **Asynchronous Counter**: O mesmo que o **Contador**, mas é coletado uma vez + para cada exportação. Pode ser usado se você não tiver acesso aos incrementos + contínuos, mas apenas ao valor agregado. +- **UpDownCounter**: Um valor que acumula ao longo do tempo, mas também pode + diminuir novamente. Um exemplo poderia ser o comprimento da fila, ele + aumentará e diminuirá com o número de itens de trabalho na fila. +- **UpDownCounter assíncrono**: O mesmo que o **UpDownCounter**, mas é coletado + uma vez para cada exportação. Pode ser usado se você não tiver acesso às + mudanças contínuas, mas apenas ao valor agregado (por exemplo, tamanho atual + da fila). +- **Gauge**: Mede um valor atual no momento em que é lido. Um exemplo seria o + medidor de combustível em um veículo. Os medidores são assíncronos. +- **Histogram**: Uma agregação de valores do lado do cliente, como latências de + solicitação. Um histograma é uma boa escolha se você estiver interessado em + estatísticas de valor. Por exemplo: Quantas solicitações levam menos de 1s? + +Para mais informações sobre instrumentos síncronos e assíncronos, e qual tipo é +mais adequado para seu caso de uso, consulte +[Diretrizes Complementares](/docs/specs/otel/metrics/supplementary-guidelines/). + +## Aggregation + +Além dos instrumentos métricos, o conceito de **agregação** é importante +entender. Uma agregação é uma técnica pela qual inúmeras medições são combinadas +em estatísticas exatas ou estimadas sobre eventos métricos que ocorreram durante +uma janela de tempo. O protocolo OTLP transporta essas métricas agregadas. A API +OpenTelemetry fornece uma agregação padrão para cada instrumento que pode ser +substituída usando as Visualizações. O projeto OpenTelemetry visa fornecer +agregações padrão suportadas por visualizadores e backends de telemetria. + +Ao contrário do [rastreamento de solicitação](/docs/concepts/signals/traces/), +cujo objetivo é capturar ciclos de vida de solicitação e fornecer contexto para +as partes individuais de uma solicitação, as métricas visam fornecer informações +estatísticas em conjunto. Alguns exemplos de casos de uso para métricas incluem: + +- Relatar o número total de bytes lidos por um serviço, por tipo de protocolo. +- Relatar o número total de bytes lidos e os bytes por solicitação. +- Relatar a duração de uma chamada de sistema. +- Relatar tamanhos de solicitação para determinar uma tendência. +- Relatar o uso de CPU ou memória de um processo. +- Relatar valores médios de saldo de uma conta. +- Relatar solicitações ativas atuais sendo manipuladas. + +## Views + +Uma visualização fornece aos usuários do SDK a flexibilidade de personalizar a +saída de métricas pelo SDK. Você pode personalizar quais instrumentos de +métricas devem ser processados ou ignorados. Você também pode personalizar a +agregação e quais atributos deseja relatar sobre métricas. + +## Language Support + +Métricas são um sinal +[estável](/docs/specs/otel/versioning-and-stability/#stable) na especificação +OpenTelemetry. Para as implementações específicas de linguagem individual da +Metrics API & SDK, o status é o seguinte: + +{{% signal-support-table "metrics" %}} + +## Specification + +Para saber mais sobre métricas no OpenTelemetry, consulte o +[especificação de métricas](/docs/specs/otel/overview/#metric-signal).