Journaux de SMS

Azure Communication Services fournit des fonctionnalités de journalisation que vous pouvez utiliser pour surveiller et déboguer votre solution Communication Services. Vous pouvez configurer ces fonctionnalités via le portail Azure.

Important

Le contenu de cet article décrit les journaux activés par le biais d’Azure Monitor (voir aussi la FAQ). Pour activer ces journaux d’activité pour vos services de communication, consultez : Activer la journalisation dans les paramètres de diagnostic.

Conditions préalables

Azure Communications Services fournit des fonctionnalités de surveillance et d’analytique via la vue d’ensemble des journaux Azure Monitor et les métriques Azure Monitor.

Chaque ressource Azure requiert son propre paramètre de diagnostic, qui définit les critères suivants :

Catégories de journaux et données métriques envoyées aux destinations définies dans les paramètres. Les catégories disponibles varient en fonction des types de ressources.
Une ou plusieurs destinations auxquelles envoyer les logs. Les destinations actuelles sont l’espace de travail Log Analytics, Event Hubs et le Stockage Azure.
Un seul paramètre de diagnostic ne peut pas définir plus d’une destination. Si vous souhaitez envoyer des données à plusieurs types de destination particuliers (par exemple, deux espaces de travail Log Analytics différents), vous devez créer plusieurs paramètres. Chaque ressource peut avoir jusqu’à cinq paramètres de diagnostic.

Suivez ces instructions pour configurer votre ressource Azure Monitor afin de commencer à créer des journaux et des métriques pour vos services de communication. Pour obtenir une documentation détaillée sur l’utilisation des paramètres de diagnostic sur toutes les ressources Azure, consultez : Activer la journalisation dans les paramètres de diagnostic.

Remarque

T pour activer les journaux d’activité pour SMS, sous le nom du paramètre de diagnostic, sélectionnez SMS Opérationnel.

Vue d’ensemble

Les journaux des opérations SMS sont des enregistrements d’événements et d’activités qui fournissent des insights sur vos requêtes d’API SMS. Les journaux capturent des détails sur les performances et la fonction de SMS. Les détails incluent l’état des messages, que le message ait été remis, bloqué ou n’a pas pu être envoyé.

Les journaux opérationnels SMS contiennent des informations permettant d’identifier les tendances et les modèles, de résoudre les problèmes susceptibles d’avoir un impact sur les performances, telles que les remises de messages ayant échoué ou les problèmes de service. Les journaux incluent les détails suivants :

Messages envoyés.
Message reçu.
Messages remis.
Acceptation et refus des messages.

Catégories de journaux de ressources

Communication Services offre les types de journaux suivants :

Journaux d’utilisation : fournit les données d’utilisation associées à chaque offre de service facturée
Journaux des opérations du service de SMS : fournit les informations de base relatives au service de SMS

Schéma des journaux d’utilisation

Propriété	Descriptif
`Timestamp`	Horodatage (UTC) de la journalisation.
`Operation Name`	Opération associée à l’enregistrement du journal.
`Operation Version`	`api-version` associé à l’opération, si operationName a été effectué à l’aide d’une API. Si aucune API ne correspond à cette opération, la version représente la version de cette opération au cas où les propriétés associées à l’opération changent à l’avenir.
`Category`	Catégorie de journal de l’événement. La catégorie est la granularité selon laquelle vous pouvez activer ou désactiver des journaux d’activité sur une ressource particulière. Les propriétés qui apparaissent dans l’objet blob de propriétés d’un événement sont les mêmes au sein d’un type de ressource et d’une catégorie de journal spécifique.
`Correlation ID`	ID des événements corrélés. Peut être utilisé pour identifier les événements corrélés entre plusieurs tables.
`Properties`	Autres données applicables aux différents modes de Communication Services.
`Record ID`	ID unique d’un enregistrement d’utilisation donné.
`Usage Type`	Mode d’utilisation. Par exemple, conversation, RTC, NAT, etc.
`Unit Type`	Type d’unité sur lequel l’utilisation est basée pour un mode d’utilisation donné. Par exemple, les minutes, les mégaoctets, les messages, etc.
`Quantity`	Nombre d’unités utilisées ou consommées pour cet enregistrement.

Journaux des opérations du service de SMS

Propriété	Descriptif
`TimeGenerated`	Horodatage (UTC) de la journalisation.
`OperationName`	Opération associée à l’enregistrement du journal.
`CorrelationID`	ID des événements corrélés. Peut être utilisé pour identifier les événements corrélés entre plusieurs tables.
`OperationVersion`	Version d’api associée à l’opération, si operationName a été effectuée à l’aide d’une API. Si aucune API ne correspond à cette opération, la version représente la version de cette opération au cas où les propriétés associées à l’opération changent à l’avenir.
`Category`	Catégorie de journal de l’événement. La catégorie est la granularité selon laquelle vous pouvez activer ou désactiver des journaux d’activité sur une ressource particulière. Les propriétés du blob des propriétés d'un événement sont identiques dans une catégorie de journal et un type de ressource particulier.
`ResultType`	État de l'opération.
`ResultSignature`	Sous-état de l’opération. Si cette opération correspond à un appel d’API REST, ce champ est le code d’état HTTP de l’appel REST correspondant.
`ResultDescription`	Description textuelle statique de cette opération.
`DurationMs`	Durée de l’opération en millisecondes.
`CallerIpAddress`	Adresse IP de l’appelant, si l’opération correspond à un appel d’API qui provient d’une entité avec une adresse IP disponible publiquement.
`Level`	Niveau de gravité de l’événement.
`URI`	URI de la requête.
`OutgoingMessageLength`	Nombre de caractères dans le message sortant.
`IncomingMessageLength`	Nombre de caractères dans le message entrant.
`DeliveryAttempts`	Nombre de tentatives effectuées pour remettre ce message.
`PhoneNumber`	Numéro de téléphone depuis lequel le message SMS est envoyé.
`SdkType`	Type de SDK utilisé dans la demande.
`PlatformType`	Type de plateforme utilisé dans la demande.
`Method`	Méthode utilisée dans la demande.
`NumberType`	Type de numéro à partir duquel le SMS est envoyé. Il peut s’agir de LongCodeNumber, ShortCodeNumber ou DynamicAlphaSenderID.
`MessageID`	Représente l’ID de message unique généré pour chaque message sortant et entrant. Recherchez le MessageId dans l’objet de réponse de l’API SMS. Le format de l’ID de message retourné par cette API est considéré comme un détail d’implémentation interne et est susceptible de changer sans préavis. Les clients doivent traiter l’ID de message comme des identificateurs opaques et ne doivent pas analyser, inférer la structure ou générer une logique en fonction de leur format ou de leur contenu.
`Country`	Représente les pays/régions à partir lesquels les sms sont envoyés ou reçus.

Exemple de journal des SMS envoyés


    [
      {
        "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"
      }
    ]

Exemple de journal des rapports de remise de SMS


    [
      {
        "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"
      }
    ]

Exemple de journal des SMS reçus


    [
      {
        "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"
      }
    ]

FAQ sur les SMS

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2025-06-19