Sdílet prostřednictvím


Přehled metrik

Azure Communication Services v současné době poskytuje metriky pro všechny primitivy komunikačních služeb Azure. Průzkumník metrik Azure se dá použít k vykreslení vlastních grafů, zkoumání odchylek v hodnotách metrik a pochopení provozu rozhraní API s využitím dat metrik, která generují e-mailové požadavky.

Kde najít metriky

Primitiva ve službě Azure Communication Services generují metriky pro požadavky rozhraní API. Tyto metriky najdete na kartě Metriky v rámci vašeho prostředku Komunikační služby. Trvalé řídicí panely můžete vytvořit také pomocí karty Sešity v rámci prostředku služby Communication Services.

Definice metrik

Všechny metriky požadavků rozhraní API obsahují tři dimenze, které můžete použít k filtrování dat metrik. Tyto dimenze lze agregovat společně pomocí Count typu agregace a podporovat všechny standardní časové řady agregace Azure, včetně Sum, Average, Mina Max.

Další informace o podporovaných typech agregace a agregacích časových řad najdete v Azure Metrics Exploreru.

  • Operace – Všechny operace nebo trasy, které je možné volat v bráně chatu služby Azure Communication Services.
  • Stavový kód – odpověď stavového kódu odeslaná po požadavku.
  • StatusSubClass – řada stavového kódu odeslaná po odpovědi.

Požadavky rozhraní API pro pokročilé zasílání zpráv

V metrikách požadavků rozhraní API pro pokročilé zasílání zpráv jsou k dispozici následující operace:

Operace / trasa Popis Scénář
DownloadMedia Stáhněte si žádost o datovou část médií. Firma požádala o stažení datové části médií.
ListTemplates Vypsat žádost o šablony Firma požádala o výpis šablon pro daný kanál.
ReceiveMessage Zpráva byla přijata. Uživatel odeslal zprávu do firmy.
SendMessage Odeslat žádost o oznámení zprávy Obchodní žádost o odeslání zprávy uživateli
SendMessageDeliveryStatus Byl doručen stav doručení. Firma přijala odpověď na zprávu, kterou firma požádala o odeslání uživateli.

Snímek obrazovky s metrikou rozšířeného požadavku na zasílání zpráv

Požadavky rozhraní API pro ověřování

V metrikách požadavků rozhraní API pro ověřování jsou k dispozici následující operace:

Operace / trasa Popis
CreateIdentity Vytvoří identitu představující jednoho uživatele.
DeleteIdentity Odstraní identitu.
CreateToken Vytvoří přístupový token.
RevokeToken Odvolá všechny přístupové tokeny vytvořené pro identitu před daným časem.
ExchangeTeamsUserAccessToken Výměna přístupového tokenu Microsoft Entra uživatele Teams pro nový přístupový token komunikační identity s odpovídajícím časem vypršení platnosti.

Snímek obrazovky s metrikou žádosti o ověření

Volání požadavků rozhraní API služby Automation

Pro metriky požadavků rozhraní API pro automatizaci volání jsou k dispozici následující operace:

Operace / trasa Popis
Vytvořit hovor Vytvoření odchozího volání pro uživatele
Přijmout hovor Přijmout příchozí hovor.
Přesměrovat hovor Přesměrujte příchozí hovor na jiného uživatele.
Odmítnout hovor Zamítnout příchozí volání.
Přepojení hovoru na účastníka Přepojení hovoru 1:1 jinému uživateli
Přehrát Přehrajte zvuk pro účastníky hovoru.
PlayPrompt Přehrajte výzvu uživatelům v rámci akce Rozpoznávání.
Recognize Rozpoznávání uživatelského vstupu od účastníků hovoru
Přidat účastníky Přidejte účastníka do hovoru.
Odebrat účastníky Odeberte účastníka z hovoru.
HangUp Call Zavěste si nohu hovoru.
Ukončit hovor Ukončete hovor pro všechny účastníky.
Získat hovor Získejte podrobnosti o hovoru.
Získat účastníka Získejte podrobnosti o účastníkovi hovoru.
Získat účastníky Získejte všechny účastníky hovoru.
Odstranit hovor Odstraňte hovor.
Zrušit všechny operace s multimédii Zrušení všech probíhajících nebo zařazených mediálních operací ve frontě ve volání

Operace metrik požadavků rozhraní API chatu

V metrikách požadavků rozhraní API chatu jsou k dispozici následující operace:

Operace / trasa Popis
GetChatMessage Získá zprávu podle ID zprávy.
ListChatMessages Získá seznam chatových zpráv z vlákna.
SendChatMessage Odešle zprávu chatu do vlákna.
UpdateChatMessage Aktualizuje zprávu chatu.
DeleteChatMessage Odstraní zprávu chatu.
GetChatThread Získá vlákno chatu.
ListChatThreads Získá seznam vláken chatu uživatele.
UpdateChatThread Aktualizuje vlastnosti vlákna chatu.
CreateChatThread Vytvoří vlákno chatu.
DeleteChatThread Odstraní vlákno.
GetReadReceipts Získá potvrzení o přečtení pro vlákno.
SendReadReceipt Odešle událost potvrzení o přečtení vláknu jménem uživatele.
SendTypingIndicator Publikuje za uživatele do vlákna zapisující událost.
ListChatThreadParticipants Získá členy vlákna.
AddChatThreadParticipants Přidá členy vlákna do vlákna. Pokud již členové existují, nedojde k žádné změně.
RemoveChatThreadParticipant Odeberte člena z vlákna.

Snímek obrazovky s metrikou žádosti rozhraní API chatu

Pokud je požadavek proveden na operaci, která není rozpoznána, obdržíte odpověď na hodnotu Chybná trasa.

Požadavky rozhraní API směrovače úloh

V metrikách požadavků rozhraní API směrovače úloh jsou k dispozici následující operace:

Operace / trasa Popis
UpsertClassificationPolicy Vytvoří nebo aktualizuje zásady klasifikace.
GetClassificationPolicy Načte existující zásadu klasifikace podle ID.
ListClassificationPolicies Načte existující zásady klasifikace.
DeleteDistributionPolicy Odstraňte zásadu klasifikace podle ID.
UpsertDistributionPolicy Vytvoří nebo aktualizuje zásady distribuce.
GetDistributionPolicy Načte existující zásady distribuce podle ID.
SeznamDistributionPolicies Načte existující zásady distribuce.
DeleteDistributionPolicy Odstraňte distribuční zásadu podle ID.
UpsertExceptionPolicy Vytvoří nebo aktualizuje zásadu výjimky.
GetExceptionPolicy Načte existující zásadu výjimky podle ID.
ListExceptionPolicies Načte existující zásady výjimek.
DeleteExceptionPolicy Odstraňte zásadu výjimky podle ID.
UpsertQueue Vytvoří nebo aktualizuje frontu.
GetQueue Načte existující frontu podle ID.
GetQueues Načte existující fronty.
DeleteQueue Odstranění fronty podle ID
GetQueueStatistics Načte statistiku fronty.
UpsertJob Vytvoří nebo aktualizuje úlohu.
GetJob Načte existující úlohu podle ID.
GetJobs Načte existující úlohy.
Odstranit úlohu Odstraňte zásadu fronty podle ID.
Přetřídění úlohy Přetřídění úlohy
Zrušit úlohu Odešle žádost o zrušení existující úlohy podle ID při zadání důvodu zrušení bezplatného formuláře.
CompleteJob Dokončí přiřazenou úlohu.
Zavřít úlohu Zavře dokončenou úlohu.
AcceptJobOffer Přijme nabídku pro práci na úloze a vrátí chybu 409/Conflict, pokud ji již přijal jiný agent.
OdmítnoutJobOffer Odmítne nabídku pro práci na úloze.
UpsertWorker Vytvoří nebo aktualizuje pracovní proces.
GetWorker Načte existujícího pracovního procesu podle ID.
GetWorkers Načte existující pracovní procesy.
DeleteWorker Odstraní pracovníka a všechny jeho trasování.

Požadavky rozhraní API pro procházení sítě

V metrikách požadavků rozhraní API pro procházení sítě jsou k dispozici následující operace:

Operace / trasa Popis
IssueRelayConfiguration Problém s konfigurací serveru STUN/TURN

Snímek obrazovky s metrikou žádosti o token TURN

Požadavky rozhraní API pro místnosti

V metrikách požadavků rozhraní ROOMS API jsou k dispozici následující operace:

Operace / trasa Popis
Vytvořit místnost Vytvoří místnost.
Odstranit místnost Odstraní místnost.
GetRoom Získá místnost podle ID místnosti.
PatchRoom Aktualizuje místnost podle ID místnosti.
Místnosti seznamů Zobrazí seznam všech místností pro prostředek Azure Communication Services.
AddParticipants Přidá účastníky do místnosti.
RemoveParticipants Odebere účastníky z místnosti.
GetParticipants Získá seznam účastníků pro místnost.
UpdateParticipants Aktualizuje seznam účastníků místnosti.

Snímek obrazovky s metrikou žádosti o místnosti

Požadavky rozhraní SMS API

V metrikách požadavků na rozhraní SMS API jsou k dispozici následující operace:

Operace / trasa Popis
SMSMessageSent Odešle zprávu SMS.
SMSDeliveryReportsReceived Získá zprávy o doručení SMS
SMSMessagesReceived Získá SMS zprávy.

Snímek obrazovky s metrikou požadavku rozhraní SMS API

Další kroky