Sdílet prostřednictvím


System.Diagnostics.Metrics Obor názvů

Metriky jsou číselné měření hlášená v průběhu času, nejčastěji se používají ke sledování stavu aplikace a generování výstrah. Webová služba může například sledovat, kolik požadavků obdrží každou sekundu, kolik milisekund trvalo odpověď a kolik odpovědí uživateli poslalo chybu. Tyto metriky je možné hlásit do monitorovacího systému v pravidelných intervalech. Obor názvů System.Diagnostics.Metrics lze použít k přidání metrik do aplikace. Rozhraní API fungují na všech platformách podporovaných platformou .NET a jsou navržená tak, aby se dobře integrovali s rostoucím ekosystémem nástrojů OpenTelemetry. Také se integrují s nástroji sady .NET SDK, jako jsou dotnet-counters. Rozhraní API naslouchacího procesu je k dispozici vývojářům, kteří chtějí vytvářet vlastní nástroje nebo adaptéry pro jiné systémy.

Třídy

Name Description
Counter<T>

Představuje nástroj, který podporuje přidávání nezáporných hodnot. Můžete například zavolat counter.Add(1) pokaždé, když se požadavek zpracuje, aby sledoval celkový počet žádostí. Většina prohlížečů metrik ve výchozím nastavení zobrazuje čítače s rychlostí (požadavky/s), ale může také zobrazit kumulativní součet.

Gauge<T>

Měřidlo je nástroj sloužící k zaznamenání nesoudatných hodnot při každé změně. Můžete například zaznamenat hodnotu úrovně šumu na pozadí místnosti, když dojde ke změnám.

Histogram<T>

Představuje nástroj metrik, který lze použít k hlášení libovolných hodnot, které budou pravděpodobně statisticky smysluplné, například dobu trvání požadavku. Voláním CreateHistogram<T>(String, String, String) vytvořte objekt Histogramu.

Instrument

Základní třída všech tříd instrumentace metrik

Instrument<T>

Základní třída pro všechny nepozorovatelné nástroje.

InstrumentAdvice<T>

Obsahuje nastavení konfigurace doporučené pro uživatele metrik při zaznamenávání měření pro danou Instrument<T>.

Meter

Měřič je třída odpovědná za vytváření a sledování nástrojů.

MeterFactoryExtensions

Rozšiřující metody pro Meter a IMeterFactory.

MeterListener

MeterListener je třída sloužící k naslouchání záznamu měření měření metrik.

MeterOptions

Možnosti pro vytvoření Meter.

ObservableCounter<T>

Představuje pozorovatelný nástroj, který hlásí monotonicky rostoucí hodnoty při sledování instrumentu, například čas procesoru (pro různé procesy, vlákna, uživatelský režim nebo režim jádra). Voláním CreateObservableCounter vytvořte pozorovatelný objekt čítače.

ObservableGauge<T>

Představuje pozorovatelný nástroj, který hlásí nedatné hodnoty, když se nástroj pozoruje, například aktuální teplota místnosti. Voláním CreateObservableGauge vytvořte pozorovatelný objekt čítače.

ObservableInstrument<T>

ObservableInstrument{T} je základní třída, ze které budou dědit všechny pozorovatelné nástroje metrik.

ObservableUpDownCounter<T>

Nástroj pozorovatelný metrikami, který hlásí zvýšení nebo snížení hodnot při sledování nástroje. Pomocí tohoto nástroje můžete například monitorovat velikost haldy procesu nebo přibližný počet položek v kruhové vyrovnávací paměti bez zámku. Chcete-li vytvořit ObservableUpDownCounter objektu, použijte CreateObservableUpDownCounter metody.

UpDownCounter<T>

Nástroj, který podporuje vykazování kladných nebo záporných hodnot metrik. UpDownCounter se může použít ve scénářích, jako je hlášení změn v aktivních požadavcích nebo velikosti fronty.

Struktury

Name Description
Measurement<T>

Ukládá jednu pozorovanou hodnotu metriky a její přidružené značky. Tento typ se používá metodou Observable instrument (Observable Observable Observable) při generování sestav aktuálních měření.

Rozhraní

Name Description
IMeterFactory

Továrna pro vytváření instancí Meter

Delegáti

Name Description
MeasurementCallback<T>

Delegát představující zpětná volání měřiče, které se používají při zaznamenávání měření.