89 lines
3.1 KiB
Markdown
89 lines
3.1 KiB
Markdown
# InterferenceETL
|
|
|
|
InterferenceETL processes the newest complete hour of interference KPI files from Metrix storage. It reads seven ZIP/XLSX source types, converts each `Sheet0` to CSV, and creates one merged interference summary.
|
|
|
|
## Output
|
|
|
|
Each run writes one window directory:
|
|
|
|
```text
|
|
output/2026073110001100/
|
|
├── converted/
|
|
│ ├── 5G下FDD干扰监控_2026073110001100.csv
|
|
│ ├── 5G干扰监控_2026073110001100.csv
|
|
│ └── ... seven source CSV files
|
|
├── interference_summary_2026073110001100.csv
|
|
└── manifest.json
|
|
```
|
|
|
|
The summary columns are:
|
|
|
|
```text
|
|
hour_start,hour_end,source_type,cgi,cell_name,interference_dbm,source_path
|
|
```
|
|
|
|
The script never modifies source storage and does not write a database yet. Pending decisions are recorded in `docs/assumptions.md`.
|
|
|
|
## Local development
|
|
|
|
```powershell
|
|
python -m pip install -r requirements.txt
|
|
python -m unittest discover -s tests -v
|
|
python main.py --source-dir C:\path\to\mock-or-exported-tree --output-dir output
|
|
```
|
|
|
|
Use `--window 2026073110001100` to require one exact source window. Without it, the script selects the newest window containing all seven source types and falls back if the newest observed window is incomplete.
|
|
|
|
## Metrix Script Management
|
|
|
|
The target server is offline, so build the runtime image on a connected machine and import it through Metrix Container Management:
|
|
|
|
```powershell
|
|
docker build -t interference-etl-runtime:1.0 .
|
|
New-Item -ItemType Directory -Force dist | Out-Null
|
|
docker save -o dist\interference-etl-runtime-1.0.tar interference-etl-runtime:1.0
|
|
```
|
|
|
|
The local `dist/` directory is intentionally excluded from Git. Transfer the generated TAR as a deployment artifact rather than source code.
|
|
|
|
Create the Metrix script project with:
|
|
|
|
```text
|
|
Name: InterferenceETL
|
|
Language: python
|
|
Base image: interference-etl-runtime:1.0
|
|
Network: bridge
|
|
Run command: python main.py
|
|
Timeout: 1800 seconds
|
|
```
|
|
|
|
Configure project environment variables in Metrix instead of committing secrets:
|
|
|
|
```json
|
|
{
|
|
"METRIX_API_BASE_URL": "http://172.17.0.1:8000",
|
|
"METRIX_API_TOKEN": "<Metrix API token>",
|
|
"METRIX_STORAGE_ID": "stg_4d9a910d72",
|
|
"INTERFERENCE_SOURCE_ROOT": "/网优日常优化数据文档/(勿删)干扰定时小时指标",
|
|
"INTERFERENCE_OUTPUT_DIR": "/workspace/output",
|
|
"INTERFERENCE_LOOKBACK_DAYS": "3",
|
|
"INTERFERENCE_PLMN": "460-00"
|
|
}
|
|
```
|
|
|
|
`172.17.0.1` is the current Linux Docker default-bridge gateway used to reach the Metrix host port. Verify it before creating the online schedule because Docker bridge configuration can differ by server.
|
|
|
|
## CLI options
|
|
|
|
```text
|
|
--source-dir PATH Read a local directory tree instead of Metrix API
|
|
--output-dir PATH Output root, default output or INTERFERENCE_OUTPUT_DIR
|
|
--window WINDOW Require an exact 16-digit source window
|
|
--lookback-days N Number of newest date directories scanned, default 3
|
|
--api-base URL Metrix API base URL
|
|
--api-token TOKEN Metrix API token
|
|
--storage-id ID Metrix storage connection ID
|
|
--root PATH Source directory in Metrix storage
|
|
--plmn PLMN LTE/SDR CGI PLMN prefix, default 460-00
|
|
```
|