Événements réseau

Le service Bell Data Streamer fournit un flux en temps réel d’événements réseau provenant de vos appareils IoT et de votre infrastructure réseau. Ces événements réseau vous offrent une visibilité complète sur la connectivité des appareils, les mises à jour de localisation, l’utilisation des données, la gestion des quotas et les activités système. Le format exact des événements réseau dépend de l’intégration utilisée, mais ce chapitre se concentre sur le format d’objet JSON délivré par le Data Streamer.

Les événements réseau sont classés en plusieurs types :

• Network Events - Mises à jour de localisation et attachements réseau
• PDP Context Events - Cycle de vie des sessions de données
• SIM Management Events - Activation de SIM et changements d’état
• Quota Events - Gestion des quotas de données et SMS
• System Events - Gestion VPN et points de terminaison

---

Aperçu de la structure des événements réseau

Tous les événements réseau partagent une structure commune avec les composants principaux suivants :

• Generic Properties - Toujours présentes dans chaque événement réseau
• Additional Properties - Informations SIM, IMSI et point de terminaison (endpoint) optionnelles
• Detail Properties - Informations supplémentaires propres au type d’événement réseau

---

Exemples d’événements réseau

Voici des exemples d’événements réseau de différentes catégories montrant la structure JSON délivrée par le Data Streamer :

Événement réseau

    {
      "id": 12345678,
      "timestamp": "2024-12-13T12:49:57.000Z",
      "event_type": {
        "id": 1,
        "description": "Update location"
      },
      "event_severity": {
        "id": 0,
        "description": "INFO"
      },
      "event_source": {
        "id": 0,
        "description": "Network"
      },
      "organisation": {
        "id": 100018,
        "name": "81013181"
      },
      "alert": false,
      "description": "New location received from VLR for IMSI = '901405105682328', now attached to VLR = '491720215095'",
      "sim": {
        "id": 10000106,
        "iccid": "8988228066605682328",
        "msisdn": "882285105682328"
      },
      "imsi": {
        "id": 100000106,
        "imsi": "901405105682328"
      },
      "endpoint": {
        "id": 100000325,
        "imei": "8697060538230193",
        "name": "8988228066605682328",
        "ip_address": "10.0.0.180"
      },
      "detail": {
        "id": 3,
        "name": "Vodafone",
        "country": {
          "id": 74,
          "mcc": "262",
          "name": "Germany",
          "iso_code": "de",
          "country_code": "49"
        },
        "mnc": [
          {
            "id": 3,
            "mnc": "02"
          }
        ],
        "tapcode": [
          {
            "id": 2,
            "tapcode": "DEUD2"
          }
        ]
      }
    }

Événement de contexte PDP

    {
      "id": 12345679,
      "timestamp": "2024-12-13T12:48:24.000Z",
      "event_type": {
        "id": 3,
        "description": "Create PDP Context"
      },
      "event_severity": {
        "id": 0,
        "description": "INFO"
      },
      "event_source": {
        "id": 0,
        "description": "Network"
      },
      "organisation": {
        "id": 100710,
        "name": "81016541"
      },
      "alert": false,
      "description": "New PDP Context successfully activated with SGSN CP=139.7.133.222, DP=139.7.133.231.",
      "sim": {
        "id": 10000675,
        "iccid": "8988228530100000018",
        "msisdn": "882285301000018"
      },
      "imsi": {
        "id": 100000676,
        "imsi": "901405301000018"
      },
      "endpoint": {
        "id": 100000821,
        "imei": "3500196576514927",
        "name": "8988228530100000018",
        "ip_address": "10.0.0.24"
      },
      "detail": {
        "id": 3,
        "name": "Vodafone",
        "country": {
          "id": 74,
          "mcc": "262",
          "name": "Germany",
          "iso_code": "de",
          "country_code": "49"
        },
        "pdp_context": {
          "pdp_context_id": 2382739057,
          "tunnel_created": "2024-12-13T12:48:24",
          "ue_ip_address": "10.0.0.24",
          "apn": "stg.eu.ng.bell.net",
          "rat_type": 6,
          "mcc": "262",
          "mnc": "02"
        }
      }
    }

Événement de quota

    {
      "id": 17254295,
      "timestamp": "2025-10-06T03:22:07.622Z",
      "event_type": {
        "id": 19,
        "description": "Quota used up"
      },
      "event_severity": {
        "id": 1,
        "description": "WARN"
      },
      "event_source": {
        "id": 1,
        "description": "Policy Control"
      },
      "organisation": {
        "id": 75488,
        "name": "90000004"
      },
      "alert": true,
      "description": "Quota volume is completely used up and data access denied for endpoint.",
      "sim": {
        "id": 10005527,
        "iccid": "8988228066680001098",
        "msisdn": "882285106459880"
      },
      "imsi": {
        "id": 100005527,
        "imsi": "901405180001098"
      },
      "endpoint": {
        "id": 100000489,
        "imei": "8686990578761101",
        "name": "8988228066680001098",
        "ip_address": "10.0.0.21"
      },
      "detail": {
        "quota": {
          "id": 876,
          "volume": -0.6077737808227539,
          "total_volume": 500,
          "threshold": {
            "volume": 100,
            "percentage": 20
          },
          "expiry_date": "2035-12-19T00:00:00Z"
        }
      }
    }

Événement de gestion SIM

    {
      "id": 17369194,
      "timestamp": "2025-10-09T10:52:27Z",
      "event_type": {
        "id": 8,
        "description": "SIM activation"
      },
      "event_severity": {
        "id": 0,
        "description": "INFO"
      },
      "event_source": {
        "id": 2,
        "description": "API"
      },
      "organisation": {
        "id": 99971,
        "name": "81053872"
      },
      "alert": false,
      "description": "Status of SIM changed from 'Suspended' to 'Activated'",
      "endpoint": {
        "id": 100112571,
        "imei": "",
        "ip_address": "10.0.0.2",
        "name": "2234567890000030861"
      },
      "imsi": {
        "id": 100050655,
        "imsi": "223456000032900"
      },
      "sim": {
        "iccid": "2234567890000030861",
        "id": 10050478,
        "msisdn": "223456000032190"
      }
    }

---

Propriétés génériques

Les propriétés génériques sont des champs toujours inclus dans un message JSON d’événement réseau reçu via le Data Streamer. Ces propriétés fournissent des informations essentielles sur chaque événement réseau.

Propriété	Type de données	Description
id	LONG (64 bits)	ID unique pour chaque événement réseau envoyé. La réception d’ID d’événements réseau dupliqués indique de possibles retransmissions.
timestamp	HORODATAGE (UTC)	Horodatage avec la date et l’heure de l’occurrence de l’événement réseau au format ISO 8601.
event_type	Objet JSON	Objet avec un id et une description de l’événement réseau survenu. Voir Event Types pour la liste de toutes les valeurs possibles.
event_severity	Objet JSON	Objet JSON avec un id et une description du niveau de sévérité de l’événement réseau. Voir Event Severity pour toutes les valeurs.
event_source	Objet JSON	Un id et une description de la source de l’événement réseau. Voir Event Source pour la liste de toutes les valeurs possibles.
organisation	Objet JSON	Objet contenant l’ID et le nom de l’organisation. Voir Event Organization pour plus d’informations.
alert	BOOLÉEN	Les événements réseau ayant un fort impact sur le fonctionnement de la connectivité sont signalés comme une alerte.
description	CHAÎNE	Chaîne contenant une description lisible par l’humain de l’événement réseau.

Event Types

Les différents types d’événements réseau sont indiqués par l’objet imbriqué Event Type. Cet objet contient un ID et une brève description de l’événement réseau. Le tableau suivant répertorie tous les types d’événements possibles pouvant être reçus via le Data Streamer.

ID d’événement	Description
1	Mise à jour de la localisation
2	Mise à jour de la localisation GPRS
3	Création de contexte PDP
4	Mise à jour du contexte PDP
5	Suppression du contexte PDP
8	Activation de la SIM
9	Suspension de la SIM
11	Terminal bloqué
15	Purge de la localisation
16	Purge de la localisation GPRS
18	Seuil de quota atteint
19	Quota épuisé
20	Seuil de quota SMS atteint
21	Quota SMS épuisé
29	Déconnexion OpenVPN
30	Authentification OpenVPN
42	Terminal activé
43	Terminal désactivé
52	Quota de données activé
53	Quota de données désactivé
54	Quota SMS activé
55	Quota SMS désactivé
56	Quota de données attribué
57	Quota de données supprimé
58	Quota SMS attribué
59	Quota SMS supprimé
60	Quota de données expiré
61	Quota SMS expiré
100	Quota de données du pool régional épuisé
101	Seuil du quota de données du pool régional atteint
102	Quota SMS du pool régional épuisé
103	Seuil du quota SMS du pool régional atteint
121	Terminal supprimé

Event Severity

Les niveaux de sévérité d’un événement réseau indiquent l’impact de l’événement sur le bon fonctionnement du système. Les valeurs possibles de sévérité sont listées ci-dessous :

ID de sévérité	Description
0	INFO
1	AVERTISSEMENT
2	AVERTISSEMENT
3	ERREUR
4	CRITIQUE

Event Source

En fonction du type d’événement, une source d’origine différente peut être responsable du déclenchement de l’événement réseau. Les sources possibles, composées d’un ID et d’une description, sont listées ci-dessous.

ID	Description
0	Réseau
1	Contrôle des politiques
2	API

Event Organization

Chaque événement réseau inclut des informations sur l’organisation d’origine. Cela aide à identifier l’organisation dans les cas d’utilisation avec plusieurs Data Streamer pour des sous-organisations. Les champs de propriétés JSON de cet objet sont listés ci-dessous.

Propriété	Type de données	Description
id	ENTIER	Identifiant unique de l’organisation
name	CHAÎNE	Nom de l’organisation

---

Propriétés supplémentaires

Les événements réseau liés directement aux SIM, aux terminaux (Endpoints) ou aux utilisateurs peuvent inclure certaines des propriétés optionnelles suivantes.

Propriété	Type de données	Description
imsi	Objet JSON	Identité d’abonné mobile international, voir IMSI Object pour plus d’informations.
sim	Objet JSON	Module d’identification de l’abonné, voir SIM Object pour plus d’informations.
endpoint	Objet JSON	Objet d’information du terminal/appareil, voir Endpoint Object pour plus d’infos.
user	CHAÎNE	Identifiant utilisateur si l’événement réseau a été déclenché par une action utilisateur spécifique.

IMSI Object

L’Identité d’abonné mobile international (IMSI) est utilisée pour identifier chaque appareil avec une SIM. Les paramètres suivants sont inclus dans un événement réseau.

Propriété	Type de données	Description
id	ENTIER	ID unique de l’IMSI.
imsi	CHAÎNE	L’Identité d’abonné mobile international sous forme de chaîne.
import_date	HORODATAGE (UTC)	Horodatage de l’approvisionnement de l’IMSI au format ISO 8601.

SIM Object

Chaque carte SIM possède des propriétés et paramètres uniques. Ces données sont incluses dans le flux d’événements réseau. La liste des champs disponibles est présentée ci-dessous.

Propriété	Type de données	Description
id	ENTIER	ID unique de la SIM.
iccid	CHAÎNE	Identifiant de la carte à circuit intégré (ICCID) de la SIM.
msisdn	CHAÎNE	ISDN de l’abonné mobile (MSISDN) de la carte SIM.
production_date	HORODATAGE (UTC)	Horodatage de la production de la SIM au format ISO 8601.

Endpoint Object

Lorsqu’une SIM est insérée dans un appareil, certaines informations sur ce terminal sont transmises via le réseau mobile. Ces informations sont utiles pour identifier le type d’appareil spécifique et certains paramètres de connexion. La liste de tous les champs de l’objet Endpoint est présentée ci-dessous.

Propriété	Type de données	Description
id	ENTIER	ID unique du terminal (Endpoint).
name	CHAÎNE	Nom de la configuration du terminal.
ip_address	CHAÎNE	Adresse IP statique spécifique de la carte SIM/du terminal.
tags	CHAÎNE	Étiquettes (tags) attribuées au terminal.
imei	CHAÎNE	Identité internationale d’équipement mobile (IMEI) du terminal/appareil.

---

Propriétés de détail

Pour certains types d’événements réseau, des paramètres d’information supplémentaires sont ajoutés dans les propriétés de détail. Le contenu varie en fonction du type d’événement réseau et fournit un contexte spécifique à cette catégorie d’événement.

Network Detail Properties

Les événements réseau incluent des informations d’opérateur et de pays dans leurs propriétés de détail.

Propriété	Type de données	Description
id	ENTIER	ID unique de l’opérateur de réseau mobile utilisé.
name	CHAÎNE	Nom de l’opérateur de réseau mobile.
country	Objet JSON	Pays de l’opérateur de réseau mobile. Voir Country Object pour plus d’informations.
mnc	TABLEAU	Tableau d’objets Mobile Network Code avec les champs id et mnc.
tapcode	TABLEAU	Tableau d’objets TAP code avec les champs id et tapcode.

PDP Context Detail Properties

Les événements de contexte PDP incluent des informations détaillées sur la session de données dans leurs propriétés de détail.

Propriété	Type de données	Description
id	ENTIER	ID unique de l’opérateur de réseau mobile utilisé.
name	CHAÎNE	Nom de l’opérateur de réseau mobile.
country	Objet JSON	Pays de l’opérateur de réseau mobile. Voir Country Object pour plus d’informations.
pdp_context	Objet JSON	Objet avec des détails sur le contexte PDP. Voir PDP Context Object pour plus d’informations.

Quota Detail Properties

Les événements de quota incluent des informations de quota et, éventuellement, des détails de pool régional.

Propriété	Type de données	Description
quota	Objet JSON	Objet avec des détails sur le quota. Voir Quota Object pour plus d’informations.
regional_pool	Objet JSON	Objet avec des informations de pool régional (pour les événements réseau de pool régional).

VPN Detail Properties

Les événements VPN incluent des informations sur le client et la connexion.

Propriété	Type de données	Description
vpn_id	ENTIER	OSS VPN ID
region	CHAÎNE	Code de région AWS
client	Objet JSON	Objet avec les champs version, private_ip et public_ip

Country Object

Un objet JSON imbriqué dans les propriétés de détail contient plus d’informations sur le pays où l’événement réseau de la SIM a eu lieu. Les champs de l’objet Pays sont listés ci-dessous.

Propriété	Type de données	Description
id	ENTIER	ID unique d’un pays.
name	CHAÎNE	Nom du pays.
country_code	CHAÎNE	Code pays
mcc	CHAÎNE	Mobile Country Code (MCC)
iso_code	CHAÎNE	Code pays ISO

PDP Context Object

Un événement réseau pour un contexte PDP inclut un large éventail d’informations supplémentaires dans les propriétés de détail. Les champs individuels sont listés ci-dessous.

Propriété	Type de données	Description
pdp_context_id	ENTIER	ID du contexte PDP
tunnel_created	HORODATAGE (UTC)	Heure de création de la session PDP
gtp_version	ENTIER	Version GTP 1/2
ggsn_control_plane_ip_address	CHAÎNE	Adresse IP du plan de contrôle GGSN/PGW
ggsn_data_plane_ip_address	CHAÎNE	Adresse IP du plan de données GGSN/PGW
sgsn_control_plane_ip_address	CHAÎNE	Adresse IP du plan de contrôle SGSN/SGW
sgsn_data_plane_ip_address	CHAÎNE	Adresse IP du plan de données SGSN/SGW
region	CHAÎNE	Région du plan de données
breakout_ip	CHAÎNE	Adresse IP utilisée pour l’Internet Breakout
apn	CHAÎNE	Nom du point d’accès (APN)
nsapi	ENTIER	Network Service Access Point Identifier (NSAPI)
ue_ip_address	CHAÎNE	Adresse IP de l’appareil
imeisv	CHAÎNE	Identité internationale d’équipement mobile - Version logicielle
mcc	CHAÎNE	Mobile Country Code (MCC)
mnc	CHAÎNE	Mobile Network Code (MNC)
lac	ENTIER	Location Area Code (LAC)
sac	ENTIER	Service Area code (SAC)
rac	ENTIER	Routing Area code (RAC)
ci	ENTIER	Cell Identification (CI)
rat_type	ENTIER	Type d’accès radio (RAT) 1 - 3G 2 - 2G 5 - HSPA+ 6 - LTE 8 - NB-IoT 9 - CAT-M
gtp_v1_uli	Objet JSON	Informations de localisation utilisateur GTP V1 avec les champs lac, ci, sac, rac
gtp_v2_uli	Objet JSON	Informations de localisation utilisateur GTP V2 avec les champs cgi, sai, rai, tac, eci, lac, menbi, emenbi
tx_teid_data_plane	ENTIER	TEID PGW/GGSN user_plane
tx_teid_control_plane	ENTIER	TEID PGW/GGSN control_plane
rx_teid	ENTIER	Identifiant de point de terminaison de tunnel reçu
tariff_id	CHAÎNE	Identifiant du tarif
operator_id	CHAÎNE	Identifiant de l’opérateur
ratezone_id	CHAÎNE	Identifiant de la zone tarifaire
ipcan_session_id	CHAÎNE	Identifiant de session IP-CAN

Quota Object

Les événements de quota incluent des informations détaillées sur l’état et l’utilisation du quota. La description du contenu des champs est listée ci-dessous.

Propriété	Type de données	Description
id	ENTIER	Identifiant unique du quota
volume	DÉCIMAL	Volume restant (peut être négatif en cas de dépassement)
total_volume	DÉCIMAL	Volume total alloué
accumulated_total_volume	DÉCIMAL	Somme de toutes les attributions de quota
last_volume_added	DÉCIMAL	Dernier ajout de quota
service	CHAÎNE	Type de service : "data" ou "sms"
threshold	Objet JSON	Objet avec les champs volume et percentage pour le paramétrage du seuil
threshold_percentage	ENTIER	Seuil en pourcentage (0-100)
threshold_volume	DÉCIMAL	Volume de seuil calculé
expiry_date	HORODATAGE (UTC)	Date d’expiration du quota
created_at	HORODATAGE (UTC)	Date de création du quota
status	Objet JSON	Objet avec id et description pour l’état du quota

---

Catégories d’événements réseau

Les événements réseau sont organisés selon les catégories fonctionnelles suivantes :

Événements réseau

Les événements réseau suivent les changements de localisation des appareils et les attachements au réseau.

Mise à jour de la localisation (ID : 1)

• Envoyé lorsque le terminal change de localisation sur le réseau CS (circuit commuté)

• Inclut les informations d’attachement au VLR

  Mise à jour de la localisation GPRS (ID : 2)

• Envoyé lorsque le terminal change de localisation sur le réseau PS (paquets commutés)

• Inclut les informations d’attachement au SGSN

  Purge de la localisation (ID : 15)

• Envoyé lorsque les informations de localisation CS sont nettoyées

  Purge de la localisation GPRS (ID : 16)

• Envoyé lorsque les informations de localisation PS sont nettoyées

Événements de contexte PDP

Les événements de contexte PDP suivent le cycle de vie des sessions de données.

Création de contexte PDP (ID : 3)

• Envoyé lorsque le terminal établit une session de données

• Inclut des détails complets du contexte PDP

• Également envoyé en cas de violations de verrouillage IMEI

  Mise à jour du contexte PDP (ID : 4)

• Envoyé lorsque la session de données est mise à jour

• Inclut des informations de contexte PDP mises à jour

  Suppression du contexte PDP (ID : 5)

• Envoyé lorsque la session de données est terminée

• Inclut l’état final du contexte PDP

Événements de gestion SIM

Les événements de gestion SIM suivent le cycle de vie de la SIM et les changements d’état.

Activation de la SIM (ID : 8)

• Envoyé lorsque l’état de la SIM passe à activé

  Suspension de la SIM (ID : 9)

• Envoyé lorsque l’état de la SIM passe à suspendu/désactivé

  Terminal activé (ID : 42)

• Envoyé lorsque l’état du terminal est défini sur activé

  Terminal désactivé (ID : 43)

• Envoyé lorsque l’état du terminal est défini sur désactivé

  Terminal bloqué (ID : 11)

• Envoyé lorsque le terminal est bloqué (par ex. limite mensuelle dépassée)

  Terminal supprimé (ID : 121)

• Envoyé lorsque le terminal est supprimé de l’organisation

Événements de quota

Les événements de quota suivent la gestion et l’utilisation des quotas de données et de SMS.

Événements de quota de données

• Quota de données activé/désactivé (ID : 52/53)

• Quota de données attribué/supprimé (ID : 56/57)

• Quota de données expiré (ID : 60)

• Seuil de quota atteint (ID : 18)

• Quota épuisé (ID : 19)

  Événements de quota SMS

• Quota SMS activé/désactivé (ID : 54/55)

• Quota SMS attribué/supprimé (ID : 58/59)

• Quota SMS expiré (ID : 61)

• Seuil de quota SMS atteint (ID : 20)

• Quota SMS épuisé (ID : 21)

  Événements de pool régional

• Quota de données/SMS du pool régional épuisé (ID : 100/102)

• Seuil de quota de données/SMS du pool régional atteint (ID : 101/103)

Événements système

Les événements système suivent les activités d’infrastructure et de service.

Événements VPN

• Authentification OpenVPN (ID : 30)

• Déconnexion OpenVPN (ID : 29)

  Ces événements réseau incluent des détails sur le client VPN et des informations de connexion.

---

Traitement des événements réseau

Lors du traitement des événements réseau provenant du Data Streamer :

1. Vérifiez l’ID de l’événement réseau : utilisez le champ unique id pour détecter les retransmissions
2. Surveillez les alertes : prêtez attention aux événements réseau où alert vaut true
3. Filtrez par sévérité : utilisez event_severity pour vous concentrer sur les problèmes critiques
4. Suivez les organisations : utilisez organisation pour séparer les scénarios multi-locataires
5. Analysez les propriétés de détail : extrayez les informations spécifiques à l’événement à partir de l’objet detail selon le type d’événement réseau