Freigeben über

SMS-Protokolle

Azure Communication Services bietet Protokollierungsfunktionen, mit deren Hilfe Sie Ihre Communication Services-Lösung überwachen und debuggen können. Sie können diese Funktionen über das Azure-Portal konfigurieren.

Wichtig

In diesem Artikel werden Protokolle beschrieben, die über Azure Monitor aktiviert sind. Siehe auch häufig gestellte Fragen .This article describes logs enabled through Azure Monitor See also FAQ. Informationen zum Aktivieren dieser Protokolle für Ihre Kommunikationsdienste finden Sie unter: Aktivieren der Protokollierung in den Diagnoseeinstellungen.

Voraussetzungen

Communications Services bietet Überwachungs- und Analysefunktionen über die Übersicht über Azure Monitor-Protokolle und Azure Monitor-Metriken.

Jede Azure-Ressource erfordert eine eigene Diagnoseeinstellung, die folgende Kriterien definiert:

  • Kategorien der Protokolle und Metrikdaten, die an die in der Einstellung definierten Ziele gesendet werden. Die verfügbaren Kategorien sind je nach Ressourcentyp verschieden.
  • Ein oder mehrere Ziele zum Senden der Protokolle. Zu den aktuellen Zielen gehören der Log Analytics-Arbeitsbereich, Event Hubs und Azure Storage.
  • Mit einer einzelnen Diagnoseeinstellung kann maximal eines der Ziele definiert werden. Wenn Sie Daten an mehrere eines bestimmten Zieltyps senden möchten (z. B. zwei verschiedene Log Analytics-Arbeitsbereiche), müssen Sie mehrere Einstellungen erstellen. Jede Ressource kann bis zu fünf Diagnoseeinstellungen haben.

Führen Sie diese Anweisungen aus, um Ihre Azure Monitor-Ressource zu konfigurieren, um mit dem Erstellen von Protokollen und Metriken für Ihre Kommunikationsdienste zu beginnen. Ausführliche Dokumentation zur Verwendung von Diagnoseeinstellungen in allen Azure-Ressourcen finden Sie unter: Aktivieren der Protokollierung in den Diagnoseeinstellungen.

Hinweis

T, um die Protokolle für SMS zu aktivieren, wählen Sie unter dem Namen der Diagnoseeinstellung SMS Operational aus.

Übersicht

SMS-Betriebsprotokolle sind Datensätze von Ereignissen und Aktivitäten, die Einblicke in Ihre SMS-API-Anforderungen bieten. Protokolle erfassen Details zur Leistung und Funktion von SMS. Details enthalten den Status von Nachrichten, ob die Nachricht erfolgreich zugestellt, blockiert oder nicht gesendet wurde.

SMS-Betriebsprotokolle enthalten Informationen, um Trends und Muster zu identifizieren und Probleme zu beheben, die sich auf die Leistung auswirken können, wie fehlgeschlagene Nachrichtenübermittlungen oder Serverprobleme. Die Protokolle enthalten die folgenden Details:

  • Gesendete Nachrichten.
  • Nachricht empfangen.
  • Übermittelte Nachrichten.
  • Nachrichten-Opt-In und -Opt-Out.

Ressourcenprotokollkategorien

Kommunikationsdienste bieten die folgenden Arten von Protokollen:

  • Nutzungsprotokolle – Stellt Nutzungsdaten bereit, die den einzelnen abgerechneten Dienstangeboten zugeordnet sind.
  • SMS-Betriebsprotokolle: Stellt grundlegende Informationen zum SMS-Dienst bereit.

Schema für Nutzungsprotokolle

Eigenschaft Beschreibung
Timestamp Der Zeitstempel (UTC), wann das Protokoll generiert wurde.
Operation Name Der mit der Protokollaufzeichnung verbundene Vorgang.
Operation Version Die api-version, die dem Vorgang zugeordnet ist, wenn für „operationName“ eine API verwendet wurde. Wenn keine API diesem Vorgang entspricht, stellt die Version die Version dieses Vorgangs dar, falls die Eigenschaften, die der Vorgangsänderung zugeordnet sind, in Zukunft geändert werden.
Category Die Protokollkategorie des Ereignisses. „category“ ist die Granularität, mit der Sie Protokolle für eine bestimmte Ressource aktivieren oder deaktivieren können. Die Eigenschaften, die im Eigenschaftenblob eines Ereignisses angezeigt werden, sind für eine bestimmte Protokollkategorie und einen Ressourcentyp gleich.
Correlation ID Die ID für korrelierte Ereignisse. Kann verwendet werden, um korrelierte Ereignisse zwischen verschiedenen Tabellen zu identifizieren.
Properties Andere Daten, die auf verschiedene Communication Services-Modi anwendbar sind.
Record ID Die eindeutige ID für einen angegebenen Nutzungsdatensatz.
Usage Type Die Art der Nutzung. Wie Chat, PSTN, NAT usw.
Unit Type Der Typ der Einheit, auf dem die Nutzung für eine bestimmte Nutzungsart basiert. Wie Minuten, Megabyte, Nachrichten usw.
Quantity Die Anzahl der für diesen Datensatz verwendeten oder verbrauchten Einheiten.

Protokolle zum SMS-Betrieb

Eigenschaft Beschreibung
TimeGenerated Der Zeitstempel (UTC), wann das Protokoll generiert wurde.
OperationName Der mit der Protokollaufzeichnung verbundene Vorgang.
CorrelationID Die ID für korrelierte Ereignisse. Kann verwendet werden, um korrelierte Ereignisse zwischen verschiedenen Tabellen zu identifizieren.
OperationVersion Die API-Version, die dem Vorgang zugeordnet ist, wenn für „operationName“ eine API verwendet wurde. Wenn keine API diesem Vorgang entspricht, stellt die Version die Version dieses Vorgangs dar, falls die Eigenschaften, die der Vorgangsänderung zugeordnet sind, in Zukunft geändert werden.
Category Die Protokollkategorie des Ereignisses. „category“ ist die Granularität, mit der Sie Protokolle für eine bestimmte Ressource aktivieren oder deaktivieren können. Die Eigenschaften im Eigenschaften-BLOB eines Ereignisses sind in einer bestimmten Protokollkategorie und einem bestimmten Ressourcentyp identisch.
ResultType Der Status des Vorgangs.
ResultSignature Der Unterstatus des Vorgangs. Wenn dieser Vorgang einem REST-API-Aufruf entspricht, ist dieses Feld der HTTP-Statuscode des entsprechenden REST-Aufrufs.
ResultDescription Die statische Textbeschreibung dieses Vorgangs.
DurationMs Die Dauer des Vorgangs in Millisekunden.
CallerIpAddress Die IP-Adresse des Aufrufers, wenn der Vorgang einem API-Aufruf entspricht, der von einer Entität mit einer öffentlich verfügbaren IP-Adresse stammt.
Level Der Schweregrad des Ereignisses.
URI Der URI der Anforderung.
OutgoingMessageLength Die Anzahl der Zeichen in der ausgehenden Nachricht.
IncomingMessageLength Die Anzahl der Zeichen in der eingehenden Nachricht.
DeliveryAttempts Die Anzahl der Versuche, die unternommen wurden, um diese Nachricht zuzustellen.
PhoneNumber Die Telefonnummer, von der die SMS-Nachricht gesendet wird.
SdkType Der in der Anforderung verwendete SDK-Typ.
PlatformType Der in der Anforderung verwendete Plattformtyp.
Method Die in der Anforderung verwendete Methode.
NumberType Der Nummerntyp, von dem die SMS-Nachricht gesendet wird. Es kann entweder LongCodeNumber, ShortCodeNumber oder DynamicAlphaSenderID sein.
MessageID Stellt die eindeutige Nachrichten-ID dar, die für jede ausgehende und eingehende Nachricht generiert wird. Suchen Sie die MessageId im SMS-API-Antwortobjekt. Das von dieser API zurückgegebene Format der Nachrichten-ID wird als internes Implementierungsdetail betrachtet und kann ohne vorherige Ankündigung geändert werden. Clients müssen Nachrichten-ID als undurchsichtige Bezeichner behandeln und dürfen keine Logik basierend auf ihrem Format oder Inhalt analysieren, strukturieren oder erstellen.
Country Stellt die Länder/Regionen dar, in denen SMS-Nachrichten an oder empfangen werden.

Beispiel für ein gesendetes SMS-Protokoll


    [
      {
        "TimeGenerated": "2022-09-26T15:58:30.100Z",
        "OperationName": "SMSMessagesSent",
        "CorrelationId": "dDRmubfpNZZZZZnxBtw3Q.0",
        "OperationVersion": "2020-07-20-preview1",
        "Category":"SMSOperational",
        "ResultType": "Succeeded",
        "ResultSignature": 202,
        "DurationMs": 130,
        "CallerIpAddress": "127.0.0.1",
        "Level": "Informational",
        "URI": "https://sms-e2e-prod.communication.azure.com/sms?api-version=2020-07-20-preview1",
        "OutgoingMessageLength": 151,
        "IncomingMessageLength": 0,
        "DeliveryAttempts": 0,
        "PhoneNumber": "+18445791704",
        "NumberType": "LongCodeNumber",
        "SdkType": "azsdk-net-Communication.Sms",
        "PlatformType": "Microsoft Windows 10.0.17763",
        "Method": "POST",
        "MessageId": "ff00e5c9-876d-4958-86e3-4637484fe5bd",
        "Country": "US"
      }
    ]

Beispiel für einen SMS-Zustellbericht.


    [
      {
        "TimeGenerated": "2022-09-26T15:58:30.200Z",
        "OperationName": "SMSDeliveryReportsReceived",
        "CorrelationId": "tl8WpUTESTSTSTccYadXJm.0",
        "Category":"SMSOperational",
        "ResultType": "Succeeded",
        "ResultSignature": 200,
        "DurationMs": 130,
        "CallerIpAddress": "127.0.0.1",
        "Level": "Informational",
        "URI": "https://global.smsgw.prod.communication.microsoft.com/rtc/telephony/sms/DeliveryReport",
        "OutgoingMessageLength": 0,
        "IncomingMessageLength": 0,
        "DeliveryAttempts": 1,
        "PhoneNumber": "+18445791704",
        "NumberType": "LongCodeNumber",
        "SdkType": "",
        "PlatformType": "",
        "Method": "POST",
        "MessageId": "ff00e5c9-876d-4958-86e3-4637484fe5bd",
        "Country": "US"
      }
    ]

Beispiel für ein SMS-Empfangsprotokoll


    [
      {
        "TimeGenerated": "2022-09-27T15:58:30.200Z",
        "OperationName": "SMSMessagesReceived",
        "CorrelationId": "e2KFTSTSTI/5PTx4ZZB.0",
        "Category":"SMSOperational",
        "ResultType": "Succeeded",
        "ResultSignature": 200,
        "DurationMs": 130,
        "CallerIpAddress": "127.0.0.1",
        "Level": "Informational",
        "URI": "https://global.smsgw.prod.communication.microsoft.com/rtc/telephony/sms/inbound",
        "OutgoingMessageLength": 0,
        "IncomingMessageLength": 110,
        "DeliveryAttempts": 0,
        "PhoneNumber": "+18445791704",
        "NumberType": "LongCodeNumber",
        "SdkType": "",
        "PlatformType": "",
        "Method": "POST",
        "MessageId": "11c6ee31-63fe-477c-8d51-f800543c6694",
        "Country": "US"
      }
    ]

Häufig gestellte Fragen zu SMS

  • Last updated on