Datasetpublic

THULab/africa-synth-telecom-network-event-logs-nigeria

Nigeria Telecom Network Event Logs (TsFile) This dataset is an Apache TsFile conversion of electricsheepafrica/africa-synth-telecom-network-event-logs-nigeria, a synthetic Nigerian telecom dataset containing detailed network event logs such as packet loss, handover failures, congestion, and connection attempts. Source Dataset Original dataset: electricsheepafrica/africa-synth-telecom-network-event-logs-nigeria Author: electricsheepafrica Category: Network… See the full description on the dataset page: https://huggingface.co/datasets/THULab/africa-synth-telecom-network-event-logs-nigeria.

sourceHugging Faceotherupdated 1mo agoView on Hugging Face

0likes31downloads

Dataset Card

Nigeria Telecom Network Event Logs (TsFile)

This dataset is an Apache TsFile conversion of `electricsheepafrica/africa-synth-telecom-network-event-logs-nigeria`, a synthetic Nigerian telecom dataset containing detailed network event logs such as packet loss, handover failures, congestion, and connection attempts.

Source Dataset

—Original dataset: `electricsheepafrica/africa-synth-telecom-network-event-logs-nigeria`
—Author: electricsheepafrica
—Category: Network Performance and Operations
—Original formats: CSV and Parquet
—Rows: 500,000
—Columns: 10
—Date generated: 2025-10-05
—Modalities: Time-series / tabular event log
—License metadata: gpl as listed in the original Hugging Face dataset card metadata. The original README body also contains a "MIT License" note.

The source dataset card describes Nigerian telecom context including major Nigerian cities, operators such as MTN, Airtel, Glo, and 9mobile, West Africa Time (WAT, UTC+1), and 2G/3G/4G/5G network types.

Converted TsFile Data

—TsFile path: network_event_logs.tsfile
—Table name: network_event_logs
—Conversion mode: Java TsFile Parquet import tool, schema mode
—Time precision: milliseconds (ms)
—Rows converted: 500,000
—Dropped columns: none
—Source file used: network_event_logs.parquet

Time, TAG, and FIELD Mapping

Source column	TsFile role	Type	Notes
`timestamp`	Time	INT64 timestamp	Original datetime column used as the TsFile time column.
`event_id`	TAG	STRING	Unique event identifier; used as the device/tag key to preserve one row per event even when timestamps repeat.
`tower_id`	FIELD	STRING	Cell tower identifier.
`city`	FIELD	STRING	Nigerian city.
`event_type`	FIELD	STRING	Network event type.
`severity`	FIELD	STRING	Event severity.
`affected_users`	FIELD	INT64	Number of affected users.
`packet_loss_percent`	FIELD	DOUBLE	Packet loss percentage.
`network_type`	FIELD	STRING	2G/3G/4G/5G network type.
`operator`	FIELD	STRING	Telecom operator.

event_id was chosen as the TAG because this is an event-log dataset rather than a regular sensor panel. The original timestamps are not globally unique; using the event identifier as the TAG avoids collisions while retaining all other non-time columns as fields.

Minimal Read Example

python

from tsfile import TsFileReader

path = "network_event_logs.tsfile"
with TsFileReader(path) as reader:
    schemas = reader.get_all_table_schemas()
    print(schemas.keys())  # includes: network_event_logs

Citation

text

Nigerian Telecom Datasets - Network Event Logs
Generated: 2025-10-05
Category: Network Performance and Operations
Rows: 500,000
Converted to Apache TsFile from the Hugging Face dataset:
electricsheepafrica/africa-synth-telecom-network-event-logs-nigeria