Glosar

Acest glosar definește termenii și conceptele noi din cadrul proiectului OpenTelemetry și clarifică utilizările specifice OpenTelemetry ale termenilor comuni din domeniul observabilității.

De asemenea, oferim comentarii privind ortografia și scrierea cu majuscule atunci când este util. De exemplu, vezi OpenTelemetry și OTel.

Termeni

Agregare

Procesul de combinare a mai multor măsurători în statistici exacte sau estimate referitoare la măsurătorile care au avut loc într-un interval de timp, în timpul execuției programului. Utilizat de Metrică Sursa de date.

API

Interfață de programare a aplicațiilor. În proiectul OpenTelemetry, utilizată pentru a defini modul în care datele de telemetrie sunt generate per Sursă de date.

Aplicație

Unul sau mai multe Servicii concepute pentru utilizatori finali sau alte aplicații.

APM

Monitorizarea performanței aplicațiilor se referă la monitorizarea aplicațiilor software, a performanței acestora (viteză, fiabilitate, disponibilitate etc.) pentru a detecta problemele, emiterea alertelor și a instrumentelor pentru găsirea cauzei principale.

Atribut

Termen OpenTelemetry pentru Metadate. Adaugă informații cheie-valoare la entitatea care produce telemetria. Se utilizează în Semnale și Resurse. Vezi specificațiile atributului.

Instrumentare automatică

Se referă la metodele de colectare a datelor de telemetrie care nu necesită ca utilizatorul final să modifice codul sursă al aplicației. Metodele variază în funcție de limbajul de programare, iar exemplele includ injecția de bytecode sau aplicarea de corecții de tip „monkey patching”.

Bagaj

Un mecanism pentru propagarea Metadatelor pentru a ajuta la stabilirea unei relații cauzale între evenimente și servicii. Vezi specificațiile bagajului.

Cardinalitate

Numărul de valori unice pentru un anumit Atribut sau set de atribute. Cardinalitatea ridicată înseamnă multe valori unice, care pot afecta cerințele de performanță și stocare ale backend-urilor de telemetrie. De exemplu, un atribut user_id ar avea cardinalitate ridicată, în timp ce un atribut status_code cu valori precum „200”, „404”, „500” ar avea cardinalitate scăzută.

Biblioteca client

Vezi biblioteca instrumentată.

Aplicația client-side

O componentă a unei Aplicații care nu rulează într-o infrastructură privată și este de obicei utilizată direct de utilizatorii finali. Exemple de aplicații client-side sunt aplicațiile de browser, aplicațiile mobile și aplicațiile care rulează pe dispozitive IoT.

Colector

Colectorul OpenTelemetry sau pe scurt Colector, este o implementare agnostică față de furnizor, despre cum se primește, se procesează și se exportă date de telemetrie. Un singur fișier binar care poate fi implementat ca agent sau gateway.

Ortografie: Când se face referire la Colectorul OpenTelemetry, scrie întotdeauna cu majusculă Colector. Folosește doar „Colector” dacă folosești Colector ca substantiv — de exemplu, „Configurația colectorului”.

Contrib

Mai multe Biblioteci de instrumentație și Colectorul oferă un set de capabilități de bază, precum și un depozit dedicat contrib pentru capabilități non-esențiale, inclusiv „Exportatori” de la furnizori.

Propagarea contextului

Permite tuturor Surselor de date să partajeze un mecanism contextual subiacent pentru stocarea stării și accesarea datelor pe durata de viață a unei Tranzacții. Vezi specificațiile de propagare a contextului.

DAG

Graf aciclic direcționat.

Sursa de date

Vezi Semnal

Dimensiune

Un termen folosit în mod specific de Metrici. Vezi Atribut.

Urmă distribuită

Urmărește progresia unei singure Cereri, numită Urmă, așa cum este gestionată de Servicii care alcătuiesc o Aplicație. O Urmărire distribuită traversează limitele de proces, rețea și securitate.

Vezi Urmărire distribuită.

Distribuție

O distribuție este un wrapper în jurul unui depozit OpenTelemetry din amonte cu anumite personalizări. Consultă Distribuții.

Eveniment

Un eveniment este o înregistrare de jurnal cu un nume de eveniment și o structură binecunoscută. De exemplu, evenimentele browserului din OpenTelemetry respectă o anumită convenție de denumire și transportă anumite date într-o structură comună.

Exportator

Oferă funcționalitate pentru emiterea de telemetrie către consumatori. Exportatorii pot fi bazați pe push sau pull.

Câmp

Un termen folosit în mod specific de Înregistrări în jurnal. Metadate pot fi adăugate prin câmpuri definite, inclusiv Atribute și Resurse. Alte câmpuri pot fi, de asemenea, considerate Metadate, inclusiv informații despre severitate și urme. Vezi specificațiile câmpului.

gRPC

Un framework universal RPC de înaltă performanță, open source. Vezi gRPC.

HTTP

Prescurtare de la Protocol de transfer hipertext.

Bibliotecă instrumentată

Indică Biblioteca pentru care sunt colectate semnalele de telemetrie (Urme, Metrici, Jurnale). Vezi Biblioteca instrumentată.

Biblioteca de instrumente

Indică Biblioteca care furnizează instrumentația pentru o anumită Biblioteca instrumentată. Biblioteca instrumentată și Biblioteca de instrumentație pot fi aceeași Bibliotecă dacă are instrumentație OpenTelemetry încorporată. Vezi specificația lib.

JSON

Prescurtare pentru JavaScript Object Notation.

Etichetă

Un termen folosit în mod specific de Metrici. Vezi Metadate.

Limbaj

Limbaj de programare.

Bibliotecă

O colecție specifică limbajului de comportamente invocate de o interfață.

Jurnal

Uneori folosit pentru a se referi la o colecție de Înregistrări jurnal. Poate fi ambiguu, deoarece uneori se folosește Jurnal și pentru a se referi la o singură Înregistrare jurnal. Unde ambiguitatea este posibilă, se utilizează calificatori suplimentari, de exemplu, Înregistrare jurnal. Vezi Jurnal.

Înregistrare în jurnal

O înregistrare a datelor cu o marcă temporală și o severitate. Poate avea și un ID de urmărire și un ID de interval atunci când este corelată cu o urmă. Vezi Înregistrare în jurnal.

Metadate

O pereche cheie-valoare, de exemplu foo="bar", adăugată la o entitate care produce telemetrie. OpenTelemetry numește aceste perechi Atribute. În plus, Metricile au Dimensiuni și Etichete, în timp ce Jurnalele au Câmpuri.

Metrică

Înregistrează un punct de date, fie măsurători brute, fie o agregare predefinită, ca serie temporală cu Metadate. Vezi Metrică.

OC

Prescurtare pentru OpenCensus.

Backend de observabilitate

Componenta unei platforme de observabilitate care este responsabilă pentru primirea, procesarea, stocarea și interogarea datelor de telemetrie. Se pot enumera, de exemplu, instrumente open source cum ar fi Jaeger și Prometheus, ​​precum și oferte comerciale. OpenTelemetry nu este un backend de observabilitate.

Frontend de observabilitate

Componenta unei platforme de observabilitate care oferă interfețe utilizator pentru vizualizarea și analiza datelor de telemetrie. Poate fi adesea o parte a unui backend de observabilitate, în special atunci când se iau în considerare ofertele comerciale.

OpAMP

Abreviere pentru Protocolul deschis de gestionare a agenților.

Ortografie: Scrie OpAMP, nu OPAMP sau opamp în descrieri sau instrucțiuni.

OpenCensus

Precursorul OpenTelemetry. Pentru mai multe detalii, vezi Istorie.

OpenTelemetry

Format printr-o fuziune a proiectelor OpenTracing și OpenCensus, OpenTelemetry — subiectul acestui site web — este o colecție de API-uri, SDK-uri și instrumente pe care le poți utiliza pentru a instrumenta, genera, colecta și exporta date de telemetrie, cum ar fi metrici, jurnale și urme.

Ortografie: OpenTelemetry ar trebui să fie întotdeauna un singur cuvânt fără cratimă și scris cu majusculă, așa cum se arată.

OpenTracing

Precursorul OpenTelemetry. Pentru mai multe detalii, vezi Istorie.

OT

Prescurtare pentru OpenTracing.

OTel

Prescurtare pentru OpenTelemetry.

Ortografie: Scrie OTel, nu OTEL.

OTelCol

Prescurtare pentru Colector OpenTelemetry.

OTEP

Un acronim pentru Propunere de îmbunătățire OpenTelemetry.

Ortografie: Scrie „OTEPs” la plural. Nu scrie OTep sau otep în descrieri.

OTLP

Prescurtare pentru Protocolul OpenTelemetry.

Propagatori

Folosit pentru serializarea și deserializarea părților specifice ale datelor de telemetrie, cum ar fi contextul intervalului și Bagajul din Intervaluri. Vezi Propagatori.

Proto

Tipuri de interfețe independente de limbă. Vezi opentelemetry-proto.

Receptor

Termenul folosit de Colector pentru a defini modul în care sunt recepționate datele de telemetrie. Receptoarele pot fi bazate pe push sau pull. Vezi Receptor.

Cerere

Vezi Urmărire distribuită.

Resursă

Capturează informații despre entitatea care produce telemetrie sub forma unor Atribute. De exemplu, un proces care produce telemetrie și care rulează într-un container pe Kubernetes are un nume de proces, un nume de pod, un namespace și, eventual, un nume de implementare. Toate aceste atribute pot fi incluse în Resursă.

REST

Prescurtare pentru Transfer de stat reprezentativ.

RPC

Prescurtare pentru Apel de procedură la distanță.

Eșantionare

Un mecanism pentru controlul cantității de date exportate. Cel mai frecvent utilizat cu Trasarea Sursei de date. Vezi Eșantionare.

SDK

Prescurtare pentru kit de dezvoltare software. Se referă la un SDK de telemetrie care denotă o Bibliotecă care implementează OpenTelemetry API.

Convenții semantice

Definește numele și valorile standard ale Metadatelor pentru a oferi date de telemetrie agnostice față de furnizor.

Serviciu

O componentă a unei Aplicații. De obicei, se implementează mai multe instanțe ale unui Serviciu pentru disponibilitate și scalabilitate ridicate. Un Serviciu poate fi implementat în mai multe locații.

Semnal

Unul dintre Urme, Metrici sau Jurnale. Vezi Semnale.

Interval

Reprezintă o singură operațiune din cadrul unei Urme. Vezi Interval.

Legătură între intervale

O legătură între intervale (span link) este o legătură între intervale (spans) legate cauzal. Pentru detalii, vezi Legături între intervale și Specificarea legăturilor.

Specificație

Descrie cerințele și așteptările interlingvistice pentru toate implementările. Vezi Specificație.

Stare

Rezultatul operației. De obicei, se folosește pentru a indica dacă a apărut o eroare. Vezi Stare.

Tag

Vezi Metadate.

Urmă

Un DAG din Intervaluri, unde punctele extreme dintre Intervaluri sunt definite ca relație părinte-copil. Vezi Urme.

Tracer

Responsabil cu crearea Intervalurilor. Vezi Tracer.

Tranzacţie

Vezi Urmărire distribuită.

zPages

O alternativă în proces la exportatorii externi. Atunci când sunt incluși, aceștia colectează și agregă informații de urmărire și metrică în fundal; aceste date sunt furnizate pe paginile web atunci când sunt solicitate. Vezi zPages.