omecproject/metricfunc

3GPP Metric Function 镜像文档

1. 镜像概述

3GPP Metric Function镜像基于3GPP（第三代合作伙伴计划）相关标准开发，旨在提供符合3GPP规范的网络指标采集、处理与报告功能。该镜像可作为独立网络功能部署，或集成至5G核心网架构中，实现对网络功能（NF）性能指标的集中化管理，支持运营商及网络部署者对网络运行状态进行实时监控与分析。

2. 核心功能与特性

• 3GPP标准合规：支持3GPP TS 28.550系列规范定义的网络性能指标（PM Counter）采集与处理流程，确保指标定义、格式及报告机制符合行业标准。
• 多类型指标处理：支持处理3GPP定义的各类指标，包括业务量指标（如会话建立成功率）、资源利用率指标（如CPU/内存使用率）、错误指标（如信令消息错误率）等。
• 灵活的采集机制：支持主动采集（定时轮询目标NF）与被动接收（接收NF主动推送的指标数据）两种模式，适配不同网络部署场景。
• 指标报告生成：可按3GPP规范格式生成指标报告，支持文件输出（如CSV、JSON格式）及接口推送（如通过REST API推送至监控平台）。
• 高兼容性：兼容5G核心网主要网络功能（如AMF、SMF、UPF等）的指标接口，支持基于HTTP/2、gRPC等协议与NF进行通信。

3. 使用场景与适用范围

• 5G核心网部署：作为5G核心网架构中的独立指标管理功能，部署于运营商网络中，集中采集与管理各NF的性能指标。
• 网络性能监控：为网络运维团队提供实时指标数据，支持故障定位、性能瓶颈分析及网络优化决策。
• 运营商合规性报告：生成符合3GPP规范的指标报告，满足运营商对网络性能数据的记录与上报要求。
• 实验室测试环境：在5G网络功能测试中，用于采集测试过程中的性能指标，辅助验证NF功能与性能是否达标。

4. 使用方法与配置说明

4.1 镜像获取

通过Docker Hub或私有镜像仓库拉取镜像：

bash
docker pull [镜像仓库地址]/3gpp-metric-function:latest

4.2 快速启动示例

使用默认配置启动容器，采集目标NF指标并输出至控制台：

bash
docker run -d \
  --name 3gpp-metric-function \
  -p 8080:8080 \  # 指标报告API端口
  -e METRIC_COLLECTION_INTERVAL=60 \  # 指标采集间隔（秒）
  -e TARGET_NF_TYPE=AMF \  # 目标网络功能类型
  -e TARGET_NF_ADDRESS=http://amf:8081 \  # 目标NF指标接口地址
  [镜像仓库地址]/3gpp-metric-function:latest

4.3 环境变量配置

4.4 持久化配置与数据

通过挂载本地目录实现自定义配置与报告持久化：

bash
docker run -d \
  --name 3gpp-metric-function \
  -p 8080:8080 \
  -v /local/config:/app/config \  # 挂载自定义配置文件目录
  -v /local/reports:/app/reports \  # 挂载报告输出目录
  -e REPORT_DESTINATION=file \
  [镜像仓库地址]/3gpp-metric-function:latest

注：自定义配置文件需符合3GPP TS 28.550规范定义的指标采集规则格式，具体可参考3GPP官方文档。

5. 注意事项

• 部署前需确保目标网络功能（NF）已启用指标接口，并配置正确的访问权限。
• 大规模部署建议结合Kubernetes等容器编排平台，以实现高可用性与扩展性。
• 镜像版本需与5G核心网版本匹配，确保指标定义与接口协议兼容性（如适配3GPP R16/R17版本规范）。