Dela via

SMS-loggar för Azure Communication Services

  • Artikel

Azure Communication Services erbjuder loggningsfunktioner som du kan använda för att övervaka och felsöka din Communication Services-lösning. Dessa funktioner kan konfigureras via Azure Portal.

Viktigt!

Följande avser loggar som är aktiverade via Azure Monitor (se även Vanliga frågor och svar). Information om hur du aktiverar dessa loggar för dina kommunikationstjänster finns i: Aktivera loggning i diagnostikinställningar

Förutsättningar

Azure Communications Services tillhandahåller övervaknings- och analysfunktioner via Översikt över Azure Monitor-loggar och Azure Monitor-mått. Varje Azure-resurs kräver en egen diagnostikinställning, som definierar följande villkor:

  • Kategorier av loggar och måttdata som skickas till de mål som definieras i inställningen. De tillgängliga kategorierna varierar för olika resurstyper.
  • Ett eller flera mål för att skicka loggarna. Aktuella mål är Log Analytics-arbetsytan, Event Hubs och Azure Storage.
  • En enda diagnostikinställning kan inte definiera fler än ett av vart och ett av målen. Om du vill skicka data till mer än en av en viss måltyp (till exempel två olika Log Analytics-arbetsytor) skapar du flera inställningar. Varje resurs kan ha upp till fem diagnostikinställningar.

Följande är instruktioner för hur du konfigurerar din Azure Monitor-resurs för att börja skapa loggar och mått för dina kommunikationstjänster. Detaljerad dokumentation om hur du använder diagnostikinställningar för alla Azure-resurser finns i: Aktivera loggning i diagnostikinställningar

Kommentar

Under namn på diagnostikinställning väljer du "SMS Operational" för att aktivera loggarna för SMS.

Översikt

SMS-driftloggar är poster för händelser och aktiviteter som ger insikter om dina SMS API-begäranden. De har samlat in information om prestanda och funktioner i SMS-primitiven, inklusive information om status för meddelandet oavsett om de har levererats, blockerats eller inte skickats. SMS-driftloggar innehåller information som hjälper dig att identifiera trender och mönster, lösa problem som kan påverka prestanda som misslyckade meddelandeleveranser eller serveproblem. Loggarna innehåller följande information:

  • Skickade meddelanden.
  • Meddelandet har tagits emot.
  • Meddelanden som levereras.
  • Meddelanden anmäler dig och avregistrerar dig.

Resursloggkategorier

Communication Services erbjuder följande typer av loggar som du kan aktivera:

  • Användningsloggar – tillhandahåller användningsdata som är associerade med varje faktureringstjänsterbjudande
  • SMS-driftloggar – ger grundläggande information om SMS-tjänsten

Schema för användningsloggar

Property beskrivning
Timestamp Tidsstämpeln (UTC) för när loggen genererades.
Operation Name Åtgärden som är associerad med loggposten.
Operation Version Associerad api-version med åtgärden, om operationName utfördes med hjälp av ett API. Om det inte finns något API som motsvarar den här åtgärden representerar versionen av åtgärden om egenskaperna som är associerade med åtgärden ändras i framtiden.
Category Loggkategorin för händelsen. Kategori är den kornighet där du kan aktivera eller inaktivera loggar på en viss resurs. Egenskaperna som visas i egenskapsbloben för en händelse är desamma inom en viss loggkategori och resurstyp.
Correlation ID ID:t för korrelerade händelser. Kan användas för att identifiera korrelerade händelser mellan flera tabeller.
Properties Andra data som gäller för olika kommunikationstjänster.
Record ID Det unika ID:t för en viss användningspost.
Usage Type Användningsläget. (till exempel Chat, PSTN, NAT osv.)
Unit Type Den typ av enhet som användningen baseras på för ett angivet användningsläge. (till exempel minuter, megabyte, meddelanden osv.).
Quantity Antalet enheter som används eller förbrukas för den här posten.

SMS-driftloggar

Property beskrivning
TimeGenerated Tidsstämpeln (UTC) för när loggen genererades.
OperationName Åtgärden som är associerad med loggposten.
CorrelationID ID:t för korrelerade händelser. Kan användas för att identifiera korrelerade händelser mellan flera tabeller.
OperationVersion Api-versionen som är associerad med åtgärden, om operationName utfördes med hjälp av ett API. Om det inte finns något API som motsvarar den här åtgärden representerar versionen av åtgärden om egenskaperna som är associerade med åtgärden ändras i framtiden.
Category Loggkategorin för händelsen. Kategori är den kornighet där du kan aktivera eller inaktivera loggar på en viss resurs. Egenskaperna som visas i egenskapsbloben för en händelse är desamma inom en viss loggkategori och resurstyp.
ResultType Status för åtgärden.
ResultSignature Åtgärdens understatus. Om den här åtgärden motsvarar ett REST API-anrop är det här fältet HTTP-statuskoden för motsvarande REST-anrop.
ResultDescription Den statiska textbeskrivningen för den här åtgärden.
DurationMs Varaktigheten för åtgärden i millisekunder.
CallerIpAddress Anroparens IP-adress, om åtgärden motsvarar ett API-anrop som skulle komma från en entitet med en offentligt tillgänglig IP-adress.
Level Allvarlighetsgraden för händelsen.
URI URI:n för begäran.
OutgoingMessageLength Antalet tecken i det utgående meddelandet.
IncomingMessageLength Antalet tecken i det inkommande meddelandet.
DeliveryAttempts Antalet försök att leverera det här meddelandet.
PhoneNumber Telefonnumret som SMS-meddelandet skickas från.
SdkType Den SDK-typ som används i begäran.
PlatformType Plattformstypen som används i begäran.
Method Den metod som används i begäran.
NumberType Typ av nummer, SMS-meddelandet skickas från. Det kan vara antingen LongCodeNumber eller ShortCodeNumber eller DynamicAlphaSenderID
MessageID Representera det unika messageId som genereras för varje utgående och inkommande meddelande. Detta finns i SMS API-svarsobjektet
Country Representera de länder/regioner där SMS-meddelandena skickades till eller togs emot från

Exempel på SMS-skickad logg


    [
      {
        "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": "Outgoing_20230118181300ff00e5c9-876d-4958-86e3-4637484fe5bd_noam",
        "Country": "US"
      }
    ]

Exempel på rapportlogg för SMS-leverans


    [
      {
        "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": "Outgoing_20230118181300ff00e5c9-876d-4958-86e3-4637484fe5bd_noam",
        "Country": "US"
      }
    ]

Exempel på SMS-mottagen logg


    [
      {
        "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": "Incoming_2023011818121211c6ee31-63fe-477c-8d51-f800543c6694",
        "Country": "US"
      }
    ]

(se även Vanliga frågor och svar).