|
| 1 | +--- |
| 2 | +title: Glossário |
| 3 | +description: >- |
| 4 | + Terminologias utilizadas pelo projeto OpenTelemetry que você pode ou não estar |
| 5 | + familiarizado. |
| 6 | +weight: 200 |
| 7 | +default_lang_commit: 926e23631291ed0ba85563cdaf344a134d0edd8d |
| 8 | +--- |
| 9 | + |
| 10 | +O projeto OpenTelemetry usa terminologias que você talvez não conheça. Além |
| 11 | +disso, o projeto também define algumas terminologias de uma maneira diferente de |
| 12 | +outros lugares. Esta página reúne as terminologias utilizadas no projeto e seus |
| 13 | +respectivos significados. |
| 14 | + |
| 15 | +## Terminologia Genérica {#generic-terminology} |
| 16 | + |
| 17 | +### **Agregação** {#aggregation} |
| 18 | + |
| 19 | +O processo de combinar múltiplas medições em estatísticas exatas ou estimadas |
| 20 | +sobre as medições que aconteceram durante um intervalo de tempo, durante a |
| 21 | +execução do programa. Utilizado pela [Fonte de Dados](#data-source) de uma |
| 22 | +[Métrica](#metric). |
| 23 | + |
| 24 | +### **Amostragem** {#sampling} |
| 25 | + |
| 26 | +Um mecanismo para controlar a quantidade de dados exportados. Usado mais |
| 27 | +comumente com a [Fonte de Dados](#data-source) de [Rastros](#trace). Consulte |
| 28 | +[mais informações][sampling]. |
| 29 | + |
| 30 | +### **API** |
| 31 | + |
| 32 | +Interface de Programação de Aplicações (_Application Programming Interface_). No |
| 33 | +projeto OpenTelemetry, é utilizada para definir como os dados de telemetria são |
| 34 | +gerados pela [Fonte de Dados](#data-source). |
| 35 | + |
| 36 | +### **Aplicação** {#application} |
| 37 | + |
| 38 | +Um ou mais [Serviços](#service) destinados a usuários finais ou outras |
| 39 | +aplicações. |
| 40 | + |
| 41 | +### **Aplicação lado do cliente** {#client-side-app} |
| 42 | + |
| 43 | +Um componente de uma [Aplicação](#application) que não está sendo executado |
| 44 | +dentro de uma infraestrutura privada e é normalmente usado diretamente por |
| 45 | +usuários finais. Exemplos de aplicações client-side incluem aplicativos de |
| 46 | +navegador, aplicativos móveis e aplicativos executados em dispositivos IoT. |
| 47 | + |
| 48 | +### **APM** |
| 49 | + |
| 50 | +O Monitoramento de Desempenho de Aplicações (_Application Performance |
| 51 | +Monitoring_) envolve monitorar aplicações de software, sua performance |
| 52 | +(velocidade, confiabilidade, disponibilidade, etc.) para detectar problemas, |
| 53 | +alertar e fornecer ferramentas que permitam encontrar a causa raiz. |
| 54 | + |
| 55 | +### **Atributo** {#attribute} |
| 56 | + |
| 57 | +Termo do OpenTelemetry para [Metadados](#metadata). Adiciona informações |
| 58 | +chave-valor à entidade que está produzindo telemetria. Usado em |
| 59 | +[Sinais](#signal) e [Recursos](#resource). Consulte a [especificação de |
| 60 | +atributos][attribute]. |
| 61 | + |
| 62 | +### **Bagagem** {#baggage} |
| 63 | + |
| 64 | +Um mecanismo para propagar [Metadados](#metadata) para ajudar a estabelecer uma |
| 65 | +relação casual entre eventos e serviços. Consulte as [especificações de |
| 66 | +Bagagem][baggage]. |
| 67 | + |
| 68 | +### **Biblioteca** {#library} |
| 69 | + |
| 70 | +Uma coleção específica da linguagem com comportamento invocado por uma |
| 71 | +interface. |
| 72 | + |
| 73 | +### **Biblioteca de cliente** {#client-library} |
| 74 | + |
| 75 | +Consulte a seção [Biblioteca instrumentada](#instrumented-library). |
| 76 | + |
| 77 | +### **Biblioteca de instrumentação** {#instrumentation-library} |
| 78 | + |
| 79 | +Indica a [Biblioteca](#library) que fornece a instrumentação para uma |
| 80 | +determinada [Biblioteca instrumentada](#instrumented-library). A |
| 81 | +[Biblioteca instrumentada](#instrumented-library) e a |
| 82 | +[Biblioteca de instrumentação](#instrumentation-library) podem ser a mesma |
| 83 | +[Biblioteca](#library) caso esta possua instrumentação OpenTelemetry |
| 84 | +incorporada. Consulte [a especificação da biblioteca][spec-instrumentation-lib]. |
| 85 | + |
| 86 | +### **Biblioteca instrumentada** {#instrumented-library} |
| 87 | + |
| 88 | +Indica a [Biblioteca](#library) para a qual os sinais telemétricos |
| 89 | +([Rastros](#trace), [Métricas](#metric), [Logs](#log)) são coletados. Consulte |
| 90 | +[mais informações][spec-instrumented-lib]. |
| 91 | + |
| 92 | +### **Campo** {#field} |
| 93 | + |
| 94 | +Um termo utilizado especificamente por [Registros de Log](#log-record). |
| 95 | +[Metadados](#metadata) podem ser adicionados por meio de campos definidos, |
| 96 | +incluindo [Atributos](#attribute) e [Recursos](#resource). Outros campos também |
| 97 | +podem ser considerados `Metadados`, incluindo severidade e informações de |
| 98 | +rastreamento. Consulte a [especificação de campos][field]. |
| 99 | + |
| 100 | +### **Collector** |
| 101 | + |
| 102 | +Uma implementação neutra em relação a fornecedores sobre como receber, processar |
| 103 | +e exportar dados de telemetria. Um único binário que pode ser implementado como |
| 104 | +um agente ou gateway. |
| 105 | + |
| 106 | +Também conhecido como OpenTelemetry Collector. Mais detalhes sobre o Collector |
| 107 | +podem ser encontrados [aqui][collector]. |
| 108 | + |
| 109 | +### **Contrib** |
| 110 | + |
| 111 | +Diversas [Bibliotecas Instrumentadas](#instrumentation-library) e o |
| 112 | +[Collector](#collector) oferecem um conjunto de funcionalidades principais, |
| 113 | +assim como um repositório contrib dedicado para funcionalidades não essenciais, |
| 114 | +incluindo `Exporters` de fornecedores. |
| 115 | + |
| 116 | +### **Convenções semânticas** {#semantic-conventions} |
| 117 | + |
| 118 | +Define nomes e valores padrão de [Metadados](#metadata) para fornecer dados |
| 119 | +telemétricos neutros em relação a fornecedores. |
| 120 | + |
| 121 | +### **DAG** |
| 122 | + |
| 123 | +[Grafos acíclicos dirigidos][dag]. |
| 124 | + |
| 125 | +### **Dimensão** {#dimension} |
| 126 | + |
| 127 | +Termo utilizado especialmente por [Métricas](#metric). Consulte |
| 128 | +[Atributo](#attribute). |
| 129 | + |
| 130 | +### **Distribuição** {#distribution} |
| 131 | + |
| 132 | +Uma distribuição é um encapsulamento em torno de um repositório upstream do |
| 133 | +OpenTelemetry com algumas personalizações. Consulte [mais |
| 134 | +detalhes][distribution]. |
| 135 | + |
| 136 | +### **Especificação** {#specification} |
| 137 | + |
| 138 | +Descreve os requisitos e expectativas para implementações em todas as |
| 139 | +linguagens. Consulte [mais informações][specification]. |
| 140 | + |
| 141 | +### **Evento** {#event} |
| 142 | + |
| 143 | +Algo que aconteceu cuja representação depende da [Fonte de dados](#data-source). |
| 144 | +Por exemplo, [Trecho](#span). |
| 145 | + |
| 146 | +### **Exporter** |
| 147 | + |
| 148 | +Fornece funcionalidades para emitir dados telemétricos aos consumidores. |
| 149 | +Exporters podem ser push-based ou pull-based. |
| 150 | + |
| 151 | +### **Fonte de dados** {#data-source} |
| 152 | + |
| 153 | +Veja [Sinal](#signal) |
| 154 | + |
| 155 | +### **gRPC** |
| 156 | + |
| 157 | +Um framework [RPC](#rpc) de alta performance e open source. Mais sobre gRPC |
| 158 | +[aqui](https://grpc.io). |
| 159 | + |
| 160 | +### **HTTP** |
| 161 | + |
| 162 | +Abreviação para [Hypertext Transfer Protocol][http]. |
| 163 | + |
| 164 | +### **Instrumentação automática** {#automatic-instrumentation} |
| 165 | + |
| 166 | +Refere-se a métodos de coleta de telemetria que não exigem que o usuário final |
| 167 | +modifique o código-fonte da aplicação. Os métodos variam conforme a linguagem de |
| 168 | +programação e os exemplos incluem injeção de _bytecode_ ou _monkey patching_. |
| 169 | + |
| 170 | +### **JSON** |
| 171 | + |
| 172 | +Abreviação para [JavaScript Object Notation][json]. |
| 173 | + |
| 174 | +### **Linguagem** |
| 175 | + |
| 176 | +Linguagem de programação. |
| 177 | + |
| 178 | +### **Log** |
| 179 | + |
| 180 | +Às vezes usado para se referir a uma coleção de [Registros de Log](#log-record). |
| 181 | +Pode ser ambíguo, uma vez que as pessoas também costumam usar [Log](#log) para |
| 182 | +se referir a um único [Registro de Log](#log-record). Quando a ambiguidade é |
| 183 | +possível, utilize qualificadores adicionais, por exemplo, `Registro de Log`. |
| 184 | +Consulte [mais informações][log]. |
| 185 | + |
| 186 | +### **Metadados** {#metadata} |
| 187 | + |
| 188 | +Um par de chave-valor, por exemplo, `foo="bar"`, adicionado a uma entidade que |
| 189 | +produz dados telemétricos. O OpenTelemetry chama esses pares de |
| 190 | +[Atributos](#attribute). Além disso, as [Métricas](#metric) têm |
| 191 | +[Dimensões](#dimension) e [Rótulos](#label), enquanto os [Logs](#log) têm |
| 192 | +[Campos](#field). |
| 193 | + |
| 194 | +### **Métrica** {#metric} |
| 195 | + |
| 196 | +Registra um ponto de dados, seja medições brutas ou agregações pré-definidas, |
| 197 | +como séries temporais com [Metadados](#metadata). Consulte [mais |
| 198 | +informações][metric]. |
| 199 | + |
| 200 | +### **OC** |
| 201 | + |
| 202 | +Abreviação para [OpenCensus](#opencensus). |
| 203 | + |
| 204 | +### **OpenCensus** |
| 205 | + |
| 206 | +Um conjunto de bibliotecas para várias linguagens que permite coletar métricas |
| 207 | +de aplicações e rastreamentos distribuídos, transferindo os dados para um |
| 208 | +backend de sua preferência em tempo real. |
| 209 | +[Precursor do OpenTelemetry](/docs/what-is-opentelemetry/#history). Consulte |
| 210 | +[mais informações][opencensus]. |
| 211 | + |
| 212 | +### **OpenTracing** |
| 213 | + |
| 214 | +APIs e instrumentações neutras em relação a fornecedores de rastreamento |
| 215 | +distribuído. [Precursor do OpenTelemetry](/docs/what-is-opentelemetry/#history). |
| 216 | +Consulte [mais informações][opentracing]. |
| 217 | + |
| 218 | +### **OT** |
| 219 | + |
| 220 | +Abreviação para [OpenTracing](#opentracing). |
| 221 | + |
| 222 | +### **OTel** |
| 223 | + |
| 224 | +Abreviação para [OpenTelemetry](/docs/what-is-opentelemetry/). |
| 225 | + |
| 226 | +### **OTelCol** |
| 227 | + |
| 228 | +Abreviação para [OpenTelemetry Collector](#collector). |
| 229 | + |
| 230 | +### **OTLP** |
| 231 | + |
| 232 | +Abreviação para [OpenTelemetry Protocol](/docs/specs/otlp/). |
| 233 | + |
| 234 | +### **Propagação de Contexto** {#context-propagation} |
| 235 | + |
| 236 | +Permite que todas as [Fontes de dados](#data-source) compartilhem um mecanismo |
| 237 | +subjacente de contexto para armazenar um estado e acessar dados ao longo do |
| 238 | +ciclo de vida de uma [Transação](#transaction). Consulte a [especificação de |
| 239 | +propagação de contexto][context propagation]. |
| 240 | + |
| 241 | +### **Propagators** |
| 242 | + |
| 243 | +Usado para serializar e desserializar partes específicas de dados telemétricos, |
| 244 | +como contexto de span e [bagagem](#baggage) em [Spans](#span). Consulte [mais |
| 245 | +informações][propagators]. |
| 246 | + |
| 247 | +### **Proto** |
| 248 | + |
| 249 | +Tipos de interface independentes de linguagem. Consulte [mais |
| 250 | +informações][proto]. |
| 251 | + |
| 252 | +### **Rastreador** {#tracer} |
| 253 | + |
| 254 | +Responsável pela criação de [Trecho](#span). Consulte [mais |
| 255 | +informações][tracer]. |
| 256 | + |
| 257 | +### **Rastro** {#trace} |
| 258 | + |
| 259 | +Um [DAG](#dag) de [Trechos](#span), onde os limites entre os [Trechos](#span) |
| 260 | +são definidos como uma relação de pai-filho. Consulte [mais informações][trace]. |
| 261 | + |
| 262 | +### **Rastro distribuído** {#distributed-tracing} |
| 263 | + |
| 264 | +Acompanha a progressão de uma única [Requisição](#request), chamada de |
| 265 | +[Rastro](#trace), conforme é processada pelos [Serviços](#service) que compõem |
| 266 | +uma [Aplicação](#application). Um [Rastro distribuído](#distributed-tracing) |
| 267 | +atravessa limites de processo, rede e segurança. |
| 268 | + |
| 269 | +Consulte [Rastreamento distribuído][distributed tracing]. |
| 270 | + |
| 271 | +### **Receiver** |
| 272 | + |
| 273 | +Termo utilizado pelo [Collector](/docs/collector/configuration/#receivers) para |
| 274 | +definir como os dados telemétricos são recebidos. Receivers podem ser push-based |
| 275 | +ou pull-based. Consulte [mais informações][receiver]. |
| 276 | + |
| 277 | +### **Recurso** {#resource} |
| 278 | + |
| 279 | +Captura informações sobre a entidade que produz dados telemétricos como |
| 280 | +[Atributos](#attribute). Por exemplo, um processo que gera telemetria e está |
| 281 | +sendo executado em um contêiner no Kubernetes possui um nome de processo, um |
| 282 | +nome de pod, um namespace e, possivelmente, um nome de deployment. Todos esses |
| 283 | +atributos podem ser incluídos no `Recurso`. |
| 284 | + |
| 285 | +### **Registro de log** {#log-record} |
| 286 | + |
| 287 | +Uma gravação de um [Evento](#event). Normalmente, o registro inclui um carimbo |
| 288 | +de data/hora indicando quando o [Evento](#event) ocorreu, além de outros dados |
| 289 | +que descrevem o que aconteceu, onde aconteceu, e assim por diante. Consulte |
| 290 | +[mais informações][log record]. |
| 291 | + |
| 292 | +### **REST** |
| 293 | + |
| 294 | +Abreviação para [Representational State Transfer][rest]. |
| 295 | + |
| 296 | +### **Requisição** {#request} |
| 297 | + |
| 298 | +Veja [Rastro distribuído](#distributed-tracing). |
| 299 | + |
| 300 | +### **Rótulo** {#label} |
| 301 | + |
| 302 | +Um termo utilizado especificamente por [Métricas](#metric). Veja |
| 303 | +[Metadados](#metadata). |
| 304 | + |
| 305 | +### **RPC** |
| 306 | + |
| 307 | +Abreviação para [Remote Procedure Call][rpc]. |
| 308 | + |
| 309 | +### **SDK** |
| 310 | + |
| 311 | +Abreviação para Software Development Kit. Refere-se a um SDK de telemetria que |
| 312 | +indica uma [Biblioteca](#library) que implementa a [API](#api) do OpenTelemetry. |
| 313 | + |
| 314 | +### **Serviço** {#service} |
| 315 | + |
| 316 | +Um componente de uma [Aplicação](#application). Múltiplas instâncias de um |
| 317 | +[Serviço](#service) são tipicamente implantadas para que tenham alta |
| 318 | +disponibilidade e escalabilidade. Um [Serviço](#service) pode ser implantado em |
| 319 | +múltiplas localizações. |
| 320 | + |
| 321 | +### **Sinal** {#signal} |
| 322 | + |
| 323 | +Um dos [Rastros](#trace), [Métricas](#metric) ou [Logs](#log). Mais sobre Sinais |
| 324 | +[aqui][signals]. |
| 325 | + |
| 326 | +### **Span link** |
| 327 | + |
| 328 | +Um span link é uma conexão entre spans relacionados casualmente. Para detalhes, |
| 329 | +consulte [Links entre spans](/docs/specs/otel/overview#links-between-spans) e |
| 330 | +[Especificando Links](/docs/specs/otel/trace/api#specifying-links). |
| 331 | + |
| 332 | +### **Status** |
| 333 | + |
| 334 | +O resultado de uma operação. Normalmente usado para indicar se ocorreu um erro. |
| 335 | +Consulte [mais informações][status]. |
| 336 | + |
| 337 | +### **Tag** |
| 338 | + |
| 339 | +Consulte [Metadados](#metadata). |
| 340 | + |
| 341 | +### **Transação** {#transaction} |
| 342 | + |
| 343 | +Consulte [Rastro distribuído](#distributed-tracing). |
| 344 | + |
| 345 | +### **Trecho** {#span} |
| 346 | + |
| 347 | +Representa uma única operação dentro de um [Rastro](#trace). Consulte mais |
| 348 | +detalhes [aqui][span]. |
| 349 | + |
| 350 | +### **zPages** |
| 351 | + |
| 352 | +Uma alternativa interna aos exportadores externos. Quando incluídos, eles |
| 353 | +coletam e agregam informações de rastros e métricas em segundo plano; estes |
| 354 | +dados são exibidos em páginas da web quando solicitados. Consulte [mais |
| 355 | +informações][zpages]. |
| 356 | + |
| 357 | +[baggage]: /docs/specs/otel/baggage/api/ |
| 358 | +[attribute]: /docs/specs/otel/common/#attributes |
| 359 | +[collector]: /docs/collector |
| 360 | +[context propagation]: /docs/specs/otel/overview#context-propagation |
| 361 | +[dag]: https://en.wikipedia.org/wiki/Directed_acyclic_graph |
| 362 | +[distributed tracing]: /docs/concepts/signals/traces/ |
| 363 | +[distribution]: /docs/concepts/distributions/ |
| 364 | +[field]: /docs/specs/otel/logs/data-model#field-kinds |
| 365 | +[http]: https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol |
| 366 | +[json]: https://en.wikipedia.org/wiki/JSON |
| 367 | +[log]: /docs/specs/otel/glossary#log |
| 368 | +[log record]: /docs/specs/otel/glossary#log-record |
| 369 | +[metric]: /docs/concepts/signals/metrics/ |
| 370 | +[opencensus]: https://opencensus.io |
| 371 | +[opentracing]: https://opentracing.io |
| 372 | +[propagators]: /docs/languages/go/instrumentation/#propagators-and-context |
| 373 | +[proto]: https://github.com/open-telemetry/opentelemetry-proto |
| 374 | +[receiver]: /docs/collector/configuration/#receivers |
| 375 | +[rest]: https://en.wikipedia.org/wiki/Representational_state_transfer |
| 376 | +[rpc]: https://en.wikipedia.org/wiki/Remote_procedure_call |
| 377 | +[sampling]: /docs/specs/otel/trace/sdk#sampling |
| 378 | +[signals]: /docs/concepts/signals/ |
| 379 | +[span]: /docs/specs/otel/trace/api#span |
| 380 | +[spec-instrumentation-lib]: /docs/specs/otel/glossary/#instrumentation-library |
| 381 | +[spec-instrumented-lib]: /docs/specs/otel/glossary/#instrumented-library |
| 382 | +[specification]: /docs/concepts/components/#specification |
| 383 | +[status]: /docs/specs/otel/trace/api#set-status |
| 384 | +[trace]: /docs/specs/otel/overview#traces |
| 385 | +[tracer]: /docs/specs/otel/trace/api#tracer |
| 386 | +[zpages]: |
| 387 | + https://github.com/open-telemetry/opentelemetry-specification/blob/main/development/trace/zpages.md |
0 commit comments