DRA 操作指南

DRA 架构概述

标准直径路由

在没有高级路由或高级转换模块的情况下，DRA 根据直径基础协议 (RFC 6733) 执行标准直径路由：

请求路由

DRA 使用 RFC 6733 第 6.1 节中定义的基于优先级的机制路由请求消息：

目标主机 AVP (293) - 如果存在，DRA 直接路由到指定的对等
- 这是最高优先级的路由机制
- 如果对等未连接，则路由失败
- 提供明确的主机级路由控制
目标域 AVP (283) - 如果目标主机缺失，则根据域路由
- DRA 选择一个连接的对等，广告支持目标域
- 当多个对等匹配该域时应用负载均衡
- 基于域的路由允许在多个主机之间灵活性
应用 ID - 根据支持的直径应用过滤对等
- 仅考虑广告支持消息的应用 ID 的对等
- 基于对等连接建立期间的能力交换 (CER/CEA)
- 参考常见 3GPP 应用 IDs

答复路由

答复包使用与请求根本不同的路由机制：

基于会话的路由: 答复包始终沿着请求的反向路径
端到端 ID 保持: 端到端标识符在所有跳数中保持不变
逐跳路由: DRA 使用逐跳标识符来维护路由状态 (在每个跳数处更改)
不进行规则评估: DRA 不会评估答复的路由规则或 AVP 内容
有状态关联: 内部路由表跟踪每个请求是由哪个对等发送的

为什么答案不通过高级模块路由:

答复路由是确定性的，必须返回到发起对等
直径协议要求答复遵循已建立的请求路径
答复的路由决策基于原始请求上下文，而不是答复内容
这确保了适当的会话管理并防止路由循环

有关答复消息路由详细信息，请参见 RFC 6733 第 6.2 节。

对等选择

当多个对等匹配路由标准时，配置的 peer_selection_algorithm 决定选择：

:random - 从可用对等中随机选择 (默认)
:failover - 始终选择列表中的第一个对等 (基于优先级)
对等必须处于 连接状态 才能被选择
断开或关闭的对等会被自动排除

标准路由的限制

无法基于 AVP 值 (例如，IMSI 模式) 定义自定义路由规则
无法进行域转换或 AVP 修改
无法基于发起对等进行路由
对流量分配的控制有限

高级路由和高级转换模块通过基于规则的路由和数据包操作能力扩展了此标准行为。

基础 DRA 配置

DRA 需要基础配置来定义其身份、网络设置和对等连接。此配置为所有路由操作奠定基础。

配置结构

%{
  host: "dra01.example.com",
  realm: "example.com",
  listen_ip: "192.168.1.10",
  listen_port: 3868,
  service_name: :example_dra,
  product_name: "OmniDRA",
  vendor_id: 10415,
  request_timeout: 5000,
  peer_selection_algorithm: :random,
  allow_undefined_peers_to_connect: false,
  log_unauthorized_peer_connection_attempts: true,
  peers: [
    # 对等配置...
  ]
}

DRA 身份参数

参数	类型	描述
`host`	字符串	DRA 的直径身份 (完全合格域名)
`realm`	字符串	DRA 的直径域
`product_name`	字符串	在 CER/CEA 消息中广告的产品名称
`vendor_id`	整数	根据 RFC 6733 第 5.3.3 节定义的供应商 ID (10415 = 3GPP)

网络设置

参数	类型	描述
`listen_ip`	字符串	DRA 监听传入连接的 IP 地址
`listen_port`	整数	直径连接的 TCP/SCTP 端口 (标准: 3868)
`service_name`	原子	内部 Erlang 服务标识符
`request_timeout`	整数	请求/答复对的超时（以毫秒为单位）（默认: 5000）

对等选择设置

参数	类型	描述
`peer_selection_algorithm`	原子	负载均衡算法: `:random` (随机选择) 或 `:failover` (第一个对等优先)
`allow_undefined_peers_to_connect`	布尔	允许来自未在配置中的对等的连接 (默认: `false`)
`log_unauthorized_peer_connection_attempts`	布尔	记录来自未授权对等的连接尝试

对等配置

peers 列表中的每个对等定义一个直径连接：

%{
  host: "mme01.operator.com",
  realm: "operator.com",
  ip: "192.168.1.20",
  port: 3868,
  transport: :diameter_tcp,
  tls: false,
  initiate_connection: false
}

对等参数

参数	类型	描述
`host`	字符串	对等的直径身份 (FQDN) - 必须与路由中的配置完全匹配
`realm`	字符串	对等的直径域
`ip`	字符串	对等的连接 IP 地址
`port`	整数	对等的直径端口 (通常为 3868)
`transport`	原子	传输协议: `:diameter_tcp` 或 `:diameter_sctp`
`tls`	布尔	启用 TLS 加密 (如果为 `true`，通常使用端口 3869)
`initiate_connection`	布尔	`true`: DRA 连接到对等，`false`: DRA 等待对等连接

连接模式

发起连接 (initiate_connection: true)

DRA 作为直径客户端
DRA 向对等发起 TCP/SCTP 连接
用于连接 HSS、PCRF 或其他后端系统
如果对等不可达，DRA 将重试连接

接受连接 (initiate_connection: false)

DRA 作为直径服务器
DRA 等待对等连接
用于 MME、SGSN、P-GW 连接
对等必须在配置中或 allow_undefined_peers_to_connect: true

配置示例

%{
  host: "dra01.mvno.example.com",
  realm: "mvno.example.com",
  listen_ip: "10.100.1.10",
  listen_port: 3868,
  service_name: :mvno_dra,
  product_name: "OmniDRA",
  vendor_id: 10415,
  request_timeout: 5000,
  peer_selection_algorithm: :random,
  allow_undefined_peers_to_connect: false,
  log_unauthorized_peer_connection_attempts: true,
  peers: [
    # MME - 等待 MME 连接
    %{
      host: "mme01.operator.example.com",
      realm: "operator.example.com",
      ip: "10.100.2.15",
      port: 3868,
      transport: :diameter_sctp,
      tls: false,
      initiate_connection: false
    },
    # HSS - DRA 发起连接
    %{
      host: "hss01.mvno.example.com",
      realm: "mvno.example.com",
      ip: "10.100.3.141",
      port: 3868,
      transport: :diameter_tcp,
      tls: false,
      initiate_connection: true
    },
    # PCRF 使用 TLS - DRA 发起安全连接
    %{
      host: "pcrf01.mvno.example.com",
      realm: "mvno.example.com",
      ip: "10.100.3.22",
      port: 3869,
      transport: :diameter_tcp,
      tls: true,
      initiate_connection: true
    }
  ]
}

重要说明

主机名匹配: 高级路由规则中的对等主机名必须与此处配置的 host 值完全匹配（区分大小写）
能力交换: 连接时，对等通过 CER/CEA 消息交换支持的应用
应用支持: DRA 广告所有支持的 3GPP 应用 (参见常见 3GPP 应用 IDs)
供应商 ID 10415: 3GPP 应用的标准值
请求超时: 影响扩展指标 TTL (超时 + 5 秒)
对等选择: 当多个对等匹配路由标准时，peer_selection_algorithm 决定选择哪个

安全注意事项

在生产环境中设置 allow_undefined_peers_to_connect: false
启用 log_unauthorized_peer_connection_attempts: true 进行安全监控
确保防火墙规则与 listen_ip 和 listen_port 设置匹配
使用 TLS 时验证对等证书

参考表

常见 3GPP 应用 IDs

应用 ID	接口	描述
16777251	S6a/S6d	MME/SGSN 到 HSS 身份验证和订阅数据
16777252	S13/S13'	MME 到 EIR 设备身份检查
16777238	Gx	PCEF 到 PCRF 策略和计费控制
16777267	S9	主 PCRF 到访问 PCRF 漫游策略
16777272	Sy	PCRF 到 OCS 会话绑定
16777216	Cx	I-CSCF/S-CSCF 到 HSS IMS 注册
16777217	Sh	AS 到 HSS IMS 用户数据
16777236	SLg	MME/SGSN 到 GMLC 位置服务
16777291	SLh	GMLC 到 HSS 位置订阅者信息
16777302	S6m	MTC-IWF 到 HSS/HLR 的 M2M 设备
16777308	S6c	SMS-SC/IP-SM-GW 到 HSS SMS 路由
16777343	S6t	SCEF 到 HSS 监控事件
16777334	Rx	AF 到 PCRF 媒体授权

常见 AVP 代码

代码	AVP 名称	类型	用法
1	用户名	UTF8String	订阅者标识符 (IMSI 在 3GPP 中)
264	Origin-Host	DiameterIdentity	发起对等主机名
268	Result-Code	Unsigned32	标准结果代码
283	Destination-Realm	DiameterIdentity	目标域
293	Destination-Host	DiameterIdentity	目标主机 (可选)
296	Origin-Realm	DiameterIdentity	源域
297	Experimental-Result	Grouped	供应商特定结果代码

常见命令代码

命令代码是直径消息头的一部分，而不是 AVP：

代码	命令名称	描述
257	CER/CEA	能力交换请求/答复
258	RAR/RAA	重新认证请求/答复
274	ASR/ASA	中止会话请求/答复
275	STR/STA	会话终止请求/答复
280	DWR/DWA	设备监控请求/答复
282	DPR/DPA	断开对等请求/答复
316	ULR/ULA	更新位置请求/答复 (S6a)
317	CLR/CLA	取消位置请求/答复 (S6a)
318	AIR/AIA	身份验证信息请求/答复 (S6a)
321	PUR/PUA	清除 UE 请求/答复 (S6a)

高级路由模块

高级路由模块提供灵活的基于规则的消息路由能力，支持复杂的匹配条件。

重要: 此模块仅评估入站直径请求包（不包括答复包）。答复包沿着已建立的会话路由返回到发起对等 - 详见答复路由。

配置

启用模块并在配置中定义路由规则：

dra_module_advanced_routing:
  enabled: True
  rules:
    - rule_name: <rule_identifier>
      match: <match_scope>
      filters: [<filter_list>]
      route:
        peers: [<peer_list>]

参数

参数	描述
`enabled`	设置为 `True` 以激活模块
`rule_name`	路由规则的唯一标识符
`match`	过滤器如何组合: `:all` (AND 逻辑 - 所有过滤器必须匹配), `:any` (OR 逻辑 - 至少一个过滤器必须匹配), `:none` (NOR 逻辑 - 无过滤器可以匹配)
`filters`	过滤条件列表 (参见可用过滤器)
`route.peers`	目标对等主机名列表 (必须是您 DRA 配置中预先配置的直径对等)，或使用特殊目标 `:destination_host` 根据目标主机 AVP (293) 进行路由

重要: 在 route.peers 中指定的对等必须是：

在 DRA 的直径对等配置中定义
与配置的主机名完全相同（区分大小写）
当前连接以确保路由成功（断开连接的对等将被跳过）

可用过滤器

标准过滤器

在高级路由和高级转换中均可用：

:application_id - 匹配直径应用 ID (参见应用 ID 参考)
- 单个值: {:application_id, 16777251} (S6a/S6d)
- 多个值: {:application_id, [16777251, 16777252]} (S6a 或 S6b)
:command_code - 匹配直径命令代码
- 单个值: {:command_code, 318} (AIR 请求)
- 多个值: {:command_code, [317, 318]} (ULR 或 AIR)
:avp - 匹配 AVP 值 (参见 AVP 代码参考)
- 精确匹配: {:avp, {296, "epc.mnc001.mcc001.3gppnetwork.org"}}
- 正则匹配: {:avp, {1, ~r"999001.*"}}
- 多个模式: {:avp, {1, ["505057001313606", ~r"999001.*", ~r"505057.*"]}}
- 任何值 (存在检查): {:avp, {264, :any}}

路由特定过滤器

仅在高级路由中可用：

:via_peer - 匹配请求来自的对等
- 单个对等: {:via_peer, "omnitouch-lab-dra01.epc.mnc001.mcc001.3gppnetwork.org"}
- 多个对等: {:via_peer, ["omnitouch-lab-dra01.epc.mnc001.mcc001.3gppnetwork.org", "omnitouch-lab-dra02.epc.mnc001.mcc001.3gppnetwork.org"]}
- 任何对等: {:via_peer, :any}

转换特定过滤器

仅在高级转换中可用：

:to_peer - 匹配预定的目标对等（仅请求包）
- 单个对等: {:to_peer, "dra01.omnitouch.com.au"}
- 多个对等: {:to_peer, ["dra01.omnitouch.com.au", "dra02.omnitouch.com.au"]}
:from_peer - 匹配发送答复的对等（仅答复包）
- 单个对等: {:from_peer, "hss-01.example.com"}
- 多个对等: {:from_peer, ["hss-01.example.com", "hss-02.example.com"]}
:packet_type - 匹配数据包方向
- 请求: {:packet_type, :request}
- 答复: {:packet_type, :answer}

重要过滤器说明

AVP 过滤器: 推荐仅用于简单 AVP (用户名、Origin-Host、Destination-Realm 等)
- 不支持分组 AVP，并且不会匹配
- 不支持复杂的二进制值
- 使用格式: {:avp, {code, value}}
列表运算符: 对于所有过滤器值（除了 :packet_type）都支持
- 当使用列表时，应用 OR 逻辑 在列表内
- 示例: {:command_code, [317, 318]} 匹配命令代码 317 或 318
特殊值:
- :any - 匹配任何值（检查 AVP 存在性）
- 示例: {:avp, {264, :any}} 匹配如果 Origin-Host AVP 存在且值为任何值

路由示例

示例 1: 通过对等路由

根据消息到达的 DRA 路由消息：

dra_module_advanced_routing:
  enabled: True
  rules:
    - rule_name: temporary_until_cutover_s6a_via_to_local_hss
      match: ":all"
      filters:
        - '{:application_id, 16777251}'
        - '{:via_peer, ["omnitouch-lab-dra01.epc.mnc001.mcc001.3gppnetwork.org", "omnitouch-lab-dra02.epc.mnc001.mcc001.3gppnetwork.org"]}'
        - '{:avp, {296, "epc.mnc001.mcc001.3gppnetwork.org"}}'
      route:
        peers: [omnitouch-lab-hss01.epc.mnc001.mcc001.3gppnetwork.org, omnitouch-lab-hss02.epc.mnc001.mcc001.3gppnetwork.org]

工作原理: 路由通过特定 DRA 对等到达的 S6a 流量到本地 HSS 节点。

示例 2: 入站漫游与模式匹配

根据 IMSI 模式路由漫游流量：

dra_module_advanced_routing:
  enabled: True
  rules:
    - rule_name: inbound_s6a_roaming_to_dcc
      match: ":all"
      filters:
        - '{:application_id, 16777251}'
        - '{:avp, {296, "epc.mnc001.mcc001.3gppnetwork.org"}}'
        - '{:avp, {1, ["505571234567", ~r"999001.*"]}}'
      route:
        peers: [dra01.omnitouch.com.au, dra02.omnitouch.com.au]

工作原理: 将来自特定 Origin-Realm 的 S6a 消息与匹配的 IMSI 模式路由到指定的 DRA 对等。

示例 3: 使用 :destination_host 的动态路由

根据消息中的目标主机 AVP 值进行路由：

dra_module_advanced_routing:
  enabled: True
  rules:
    - rule_name: route_to_specified_destination_host
      match: ":all"
      filters:
        - '{:avp, {1, [~r"90199.*"]}}'  # 匹配 IMSI 模式
      route: :destination_host

工作原理:

当过滤器匹配时，路由到目标主机 AVP (293) 中指定的对等
如果目标主机 AVP 缺失，则匹配被视为失败，回退到正常路由
当发送者指定确切目标时，适用于荣誉路由

高级转换模块

高级转换模块根据匹配条件动态修改直径消息 AVP。有关规则评估的详细信息，请参见规则处理。

配置

启用模块并定义转换规则：

dra_module_advanced_transform:
  enabled: True
  rules:
    - rule_name: <rule_identifier>
      match: <match_scope>
      filters: [<filter_list>]
      transform:
        action: <transform_action>
        avps: [<avp_modifications>]

参数

参数	描述
`enabled`	设置为 `True` 以激活模块
`rule_name`	转换规则的唯一标识符
`match`	过滤器如何组合: `:all` (AND 逻辑), `:any` (OR 逻辑), `:none` (NOR 逻辑) - 参见过滤器逻辑
`filters`	过滤条件列表 (参见可用过滤器)
`transform.action`	转换类型 (`:edit`, `:remove`, 或 `:overwrite`)
`transform.avps`	要应用的 AVP 修改列表 (参见 AVP 代码参考)

转换操作

请求包 (直径请求)

:edit - 修改现有 AVP 值
- 仅修改消息中存在的 AVP
- 如果 AVP 不存在，则不进行更改
:remove - 从消息中移除 AVP
:overwrite - 替换整个 AVP 结构
- 需要指定直径字典的 dictionary 参数（例如，:diameter_gen_3gpp_s6a）

答复包 (直径答复)

:remove - 从消息中移除 AVP
:overwrite - 替换整个 AVP 结构
- 需要 dictionary 参数

重要: 如果没有规则匹配，数据包将透明传递，不进行任何转换。

AVP 修改语法

标准修改:

{:avp, {<code>, <new_value>}} - 将 AVP 设置为新值

移除 AVP:

{:avp, {<code>, :any}} - 按 ID 移除 AVP（无论当前值如何均移除）
注意: 按 avp_id 移除是支持的；按 AVP 内容移除是不支持的

使用字典进行覆盖:

transform: %{
  action: :overwrite,
  dictionary: :diameter_gen_3gpp_s6a,
  avps: [{:avp, {:"s6a_Supported-Features", {:"s6a_Supported-Features", 10415, 1, 3221225470, []}}}]
}

转换示例

示例 1: 基于对等的域重写

根据消息被路由到的地方重写目标域：

dra_module_advanced_transform:
  enabled: True
  rules:
    - rule_name: rewrite_s6a_destination_realm_for_Operator_X
      match: ":all"
      filters:
        - '{:to_peer, ["dra01.omnitouch.com.au", "dra02.omnitouch.com.au"]}'
        - '{:avp, {296, "epc.mnc001.mcc001.3gppnetwork.org"}}'
        - '{:avp, {1, [~r"9999999.*"]}}'
      transform:
        action: ":edit"
        avps:
          - '{:avp, {283, "epc.mnc999.mcc999.3gppnetwork.org"}}'

工作原理: 当 S6a 请求被路由到特定 DRA 对等并匹配 IMSI 模式时，重写 Operator X 网络的目标域。

示例 2: 多运营商路由与转换

dra_module_advanced_transform:
  enabled: True
  rules:
    - rule_name: rewrite_s6a_destination_realm_for_roaming_partner_ausie
      match: ":all"
      filters:
        - '{:to_peer, ["dra01.omnitouch.com.au", "dra02.omnitouch.com.au"]}'
        - '{:avp, {296, "epc.mnc057.mcc505.3gppnetwork.org"}}'
        - '{:avp, {1, [~r"50557.*"]}}'
      transform:
        action: ":edit"
        avps:
          - '{:avp, {283, "epc.mnc030.mcc310.3gppnetwork.org"}}'

工作原理: 根据 IMSI 模式将不同的 IMSI 订阅者范围路由到适当的网络域。第一个匹配规则优先（参见执行顺序）。

示例 3: MVNO 域重写

dra_module_advanced_transform:
  enabled: True
  rules:
    - rule_name: rewrite_s6a_destination_realm_for_single_sub
      match: ":all"
      filters:
        - '{:to_peer, ["dra01.omnitouch.com.au", "dra02.omnitouch.com.au"]}'
        - '{:avp, {296, "epc.mnc001.mcc001.3gppnetwork.org"}}'
        - '{:avp, {1, ["505057000003606"]}}'  # 精确 IMSI 匹配
      transform:
        action: ":edit"
        avps:
          - '{:avp, {283, "epc.mnc001.mcc001.3gppnetwork.org"}}'

工作原理: 将特定 MVNO 订阅者的目标域转换为其托管核心网络。

示例 4: 仅请求转换与数据包类型过滤器

仅转换请求包（不包括答复）：

dra_module_advanced_transform:
  enabled: True
  rules:
    - rule_name: Tutorial_Rule_AIR
      match: ":all"
      filters:
        - '{:application_id, 16777251}'
        - '{:command_code, 318}'
        - '{:packet_type, :request}'
        - '{:avp, {1, "999999000000001"}}'
        - '{:avp, {264, :any}}'  # Origin-Host 必须存在且值为任何值
      transform:
        action: ":edit"
        avps:
          - '{:avp, {1, "999999000000002"}}'

工作原理:

仅匹配 S6a AIR 请求包（不包括答复包）
检查用户名 (AVP 1) 是否等于 "999999000000001"
验证 Origin-Host (AVP 264) 是否存在且值为任何值
将用户名重写为 "999999000000002"
如果 AVP 不存在，则不进行更改

示例 5: 移除 AVP

从消息中移除特定 AVP：

dra_module_advanced_transform:
  enabled: True
  rules:
    - rule_name: remove_user_name_avp
      match: ":all"
      filters:
        - '{:application_id, 16777251}'
      transform:
        action: ":remove"
        avps:
          - '{:avp, {1, :any}}'  # 无论值如何均移除用户名

工作原理: 从所有 S6a 消息中移除用户名 AVP (代码 1)，无论其当前值如何。

示例 6: 在答复包上覆盖分组 AVP

使用字典支持修改答复包中的复杂分组 AVP：

dra_module_advanced_transform:
  enabled: True
  rules:
    - rule_name: add_sos_apn_to_ula
      match: ":all"
      filters:
        - '{:application_id, 16777251}'       # S6a/S6d
        - '{:command_code, 316}'              # ULA (更新位置答复)
        - '{:packet_type, :answer}'           # 仅答复包
        - '{:avp, {296, "epc.mnc001.mcc001.3gppnetwork.org"}}'  # Origin-Realm
      transform:
        action: ":overwrite"
        dictionary: ":diameter_gen_3gpp_s6a"
        avps:
          - '{:avp, {:"s6a_APN-Configuration-Profile",
              {:"s6a_APN-Configuration-Profile", 1, 0, [
                {:"s6a_APN-Configuration", 1, 0, "internet", [],
                  [{:"s6a_EPS-Subscribed-QoS-Profile", 9,
                    {:"s6a_Allocation-Retention-Priority", 1, [0], [0], []}, []}],
                  [1], [], [], [1], ["0800"],
                  [{:s6a_AMBR, 4200000000, 4200000000, [], [], []}],
                  [], [], [], [], [], [], [], [], [], [], [], [], [], [], []},
                {:"s6a_APN-Configuration", 2, 0, "ims", [],
                  [{:"s6a_EPS-Subscribed-QoS-Profile", 5,
                    {:"s6a_Allocation-Retention-Priority", 1, [0], [1], []}, []}],
                  [0], [], [], [1], ["0800"],
                  [{:s6a_AMBR, 4200000000, 4200000000, [], [], []}],
                  [], [], [], [], [], [], [], [], [], [], [], [], [], [], []},
                {:"s6a_APN-Configuration", 3, 0, "sos", [],
                  [{:"s6a_EPS-Subscribed-QoS-Profile", 5,
                    {:"s6a_Allocation-Retention-Priority", 1, [0], [1], []}, []}],
                  [1], [], [], [1], ["0800"],
                  [{:s6a_AMBR, 4200000000, 4200000000, [], [], []}],
                  [], [], [], [], [], [], [], [], [], [], [], [], [], [], []}
              ], []}
            }}'

工作原理:

匹配来自特定 Origin-Realm 的 S6a 更新位置答复 (ULA) 包
使用 :overwrite 操作替换整个 APN-Configuration-Profile 分组 AVP
需要 dictionary 参数 以正确编码复杂的分组 AVP 结构
添加三个 APN 配置: "internet" (上下文 1)、"ims" (上下文 2) 和 "sos" (上下文 3)
每个 APN 包括 QoS 配置、带宽限制 (AMBR) 和 PDN 类型设置
该转换确保所有来自此域的订阅者都为紧急服务 (SOS) APN 提供服务

何时使用 :overwrite 与字典:

修改具有嵌套结构的分组 AVP（如 APN-Configuration-Profile）
添加或重组复杂的 3GPP 订阅数据
当 :edit 操作无法处理 AVP 复杂性时
字典必须与直径应用匹配（S6a 的 :diameter_gen_3gpp_s6a 等）

重要说明:

:overwrite 替换整个 AVP，而不仅仅是单个字段
AVP 结构必须与字典定义完全匹配
不正确的结构将导致编码失败和丢失数据包
这是��个高级功能 - 在测试环境中先进行彻底验证

用例

MVNO 支持: 将虚拟运营商流量路由到托管核心网络
网络迁移: 逐步将订阅者重定向到新基础设施
域转换: 在漫游合作伙伴之间转换不同的命名方案
多租户: 按域隔离订阅者群体
运营商路由: 根据 IMSI 范围将流量直接路由到正确的运营商网络

规则处理

适用于高级路由和高级转换模块。

执行顺序

规则按配置中定义的从上到下的顺序进行评估
规则中的过滤器根据 match 参数进行评估（:all、:any 或 :none）
第一个匹配规则胜出 - 不再评估后续规则
如果没有规则匹配，则使用默认路由/透传行为

过滤器逻辑

match 参数决定过滤器如何组合：

match: :all (AND 逻辑)

所有过滤器必须匹配才能使规则成功。

示例: 对于 3 个过滤器，filter1 AND filter2 AND filter3 必须全部为真。

match: :any (OR 逻辑)

至少一个过滤器必须匹配才能使规则成功。

示例: 对于 3 个过滤器，filter1 OR filter2 OR filter3 (任意一个通过)。

match: :none (NOR 逻辑)

规则成功时不能匹配任何过滤器（反向匹配）。

示例: 对于 3 个过滤器，NOT filter1 AND NOT filter2 AND NOT filter3 (全部必须失败)。

附加说明:

在使用过滤器值中的列表运算符时（例如，{:avp, {1, ["value1", "value2"]}}），值使用 OR 逻辑（任意一个可以匹配）。

正则表达式模式

使用 ~r"pattern" 语法进行正则匹配：

~r"999001.*" - 匹配以 999001 开头的 IMSI
~r"^310[0-9]{3}.*" - 匹配具有特定 MNC 模式的 IMSI
~r".*test$" - 匹配以 "test" 结尾的值

最佳实践

特异性: 按从最特定到最一般的顺序排列规则
性能: 将最常见的匹配放在前面，以减少处理开销
测试: 在部署前验证正则表达式模式
文档: 使用描述性的 rule_name 值以便于操作清晰
监控: 跟踪规则匹配率以验证预期行为

扩展指标模块

扩展指标模块提供高级遥测和分析能力，用于分析超出标准指标的直径流量模式。

配置

启用模块并配置特定指标类型：

module_extended_metrics:
  enabled: true
  attach_attempt_reporting_enabled: true

参数

参数	描述
`enabled`	设置为 `true` 以激活扩展指标模块
`attach_attempt_reporting_enabled`	启用对 LTE 附加尝试 (S6a AIR/AIA) 的跟踪和报告

可用指标

附加尝试跟踪

通过监控身份验证信息请求 (AIR) 和答复 (AIA) 消息对来跟踪 LTE 订阅者的附加尝试：

测量: attach_attempt_count

字段:

imsi - 订阅者 IMSI (来自用户名 AVP - 参见 AVP 代码)

标签:

origin_host - 发起附加请求的对等
result_code - HSS 响应中的直径结果代码

工作原理:

当接收到 AIR (命令代�� 318，S6a 应用 16777251 - 参见应用 IDs) 时，模块提取：
- 用于请求/响应关联的端到端 ID
- IMSI (用户名 AVP 代码 1)
- Origin-Host (AVP 代码 264)
请求元数据存储在 ETS 中，带有 TTL
当收到匹配的 AIA 时，模块：
- 使用端到端 ID 进行关联
- 提取结果代码 (AVP 268 或实验结果代码 AVP 297)
- 以 IMSI、origin host 和结果代码发出指标

用例

附加成功率分析 - 跟踪成功与失败的附加尝试及其结果代码
IMSI 级故障排除 - 识别经历附加失败的订阅者
网络性能监控 - 按来源 (MME/SGSN) 监控附加尝试模式
漫游分析 - 分析入站漫游附加成功率

集成

扩展指标通过 InfluxDB 集成导出：

DRA.Metrics.InfluxDB.write(%{
  measurement: "attach_attempt_count",
  fields: %{imsi: "505057000000001"},
  tags: %{origin_host: "mme-01.example.com", result_code: 2001}
})

结果代码是标准直径代码：

2001 - 成功 (DIAMETER_SUCCESS)
5001 - 身份验证失败 (DIAMETER_AUTHENTICATION_REJECTED)
5004 - 直径 AVP 不支持
有关完整结果代码列表，请参见 RFC 6733

重要说明

附加尝试指标仅跟踪 S6a AIR/AIA 对 (应用 ID 16777251，命令代码 318)
请求元数据根据配置的请求超时 + 5 秒过期
指标处理是异步的（生成的进程），以避免阻塞消息流
该模块独立于路由和转换模块操作

故障排除

规则未匹配

验证所有过滤条件是否正确
检查 AVP 代码是否与您的直径应用匹配（参见 AVP 代码参考）
独立测试正则表达式模式（参见正则表达式模式）
确保消息类型与 match 范围匹配（参见过滤器逻辑）
查看可用过滤器以确保您使用了正确的模块过滤器类型

意外路由

查看规则顺序 - 第一个匹配胜出
验证对等名称是否正确且可达
检查是否存在重叠过滤器的冲突规则
确认在没有规则匹配时的标准直径路由行为

转换未应用

确认 AVP 代码是否适合您的用例（参见 AVP 代码参考）
对于 :edit 操作: 验证 AVP 是否存在于消息中（编辑不会创建新 AVP）
检查过滤器是否与预期的消息流匹配
验证是否使用了数据包类型过滤器（:request 与 :answer）
确保操作对于数据包类型是支持的（:edit 仅适用于请求 - 参见转换操作）
查看规则处理以获取执行顺序

目录​

DRA 架构概述​

标准直径路由​

请求路由​

答复路由​

对等选择​

标准路由的限制​

基础 DRA 配置​

配置结构​

DRA 身份参数​

网络设置​

对等选择设置​

对等配置​

对等参数​

连接模式​

配置示例​

重要说明​

安全注意事项​

参考表​

常见 3GPP 应用 IDs​

常见 AVP 代码​

常见命令代码​

高级路由模块​

配置​

参数​

可用过滤器​

标准过滤器​

路由特定过滤器​

转换特定过滤器​

重要过滤器说明​

路由示例​

示例 1: 通过对等路由​

示例 2: 入站漫游与模式匹配​

示例 3: 使用 :destination_host 的动态路由​

高级转换模块​

配置​

参数​

转换操作​

请求包 (直径请求)​

答复包 (直径答复)​

AVP 修改语法​

转换示例​

示例 1: 基于对等的域重写​

示例 2: 多运营商路由与转换​

示例 3: MVNO 域重写​

示例 4: 仅请求转换与数据包类型过滤器​

示例 5: 移除 AVP​

示例 6: 在答复包上覆盖分组 AVP​

用例​

规则处理​

执行顺序​

过滤器逻辑​

match: :all (AND 逻辑)​

match: :any (OR 逻辑)​

match: :none (NOR 逻辑)​

正则表达式模式​

最佳实践​

扩展指标模块​

配置​

参数​

可用指标​

附加尝试跟踪​

用例​

集成​

重要说明​

故障排除​

规则未匹配​

意外路由​

转换未应用​

目录

DRA 架构概述

标准直径路由

请求路由

答复路由

对等选择

标准路由的限制

基础 DRA 配置

配置结构

DRA 身份参数

网络设置

对等选择设置

对等配置

对等参数

连接模式

配置示例

重要说明

安全注意事项

参考表

常见 3GPP 应用 IDs

常见 AVP 代码

常见命令代码

高级路由模块

配置

参数

可用过滤器

标准过滤器

路由特定过滤器

转换特定过滤器

重要过滤器说明

路由示例

示例 1: 通过对等路由

示例 2: 入站漫游与模式匹配

示例 3: 使用 :destination_host 的动态路由

高级转换模块

配置

参数

转换操作

请求包 (直径请求)

答复包 (直径答复)

AVP 修改语法

转换示例

示例 1: 基于对等的域重写

示例 2: 多运营商路由与转换

示例 3: MVNO 域重写

示例 4: 仅请求转换与数据包类型过滤器

示例 5: 移除 AVP

示例 6: 在答复包上覆盖分组 AVP

用例

规则处理

执行顺序

过滤器逻辑

match: :all (AND 逻辑)

match: :any (OR 逻辑)

match: :none (NOR 逻辑)

正则表达式模式

最佳实践

扩展指标模块

配置

参数

可用指标

附加尝试跟踪

用例

集成

重要说明

故障排除

规则未匹配

意外路由

转换未应用