Guia de Operações do DRA

Índice

Roteamento de Diâmetro Padrão
Configuração Base do DRA
Tabelas de Referência
- IDs de Aplicação 3GPP Comuns
- Códigos AVP Comuns
Módulo de Roteamento Avançado
Módulo de Transformação Avançada
Processamento de Regras
Módulo de Métricas Estendidas
Solução de Problemas

Visão Geral da Arquitetura do DRA

Roteamento de Diâmetro Padrão

Sem os módulos Roteamento Avançado ou Transformação Avançada, o DRA realiza o roteamento padrão de Diâmetro com base no Protocolo Base de Diâmetro (RFC 6733):

Roteamento de Requisições

O DRA roteia mensagens de requisição usando um mecanismo baseado em prioridade definido na Seção 6.1 da RFC 6733:

AVP Destino-Host (293) - Se presente, o DRA roteia diretamente para o par especificado
- Este é o mecanismo de roteamento de mais alta prioridade
- Se o par não estiver conectado, o roteamento falha
- Fornece controle de roteamento explícito em nível de host
AVP Destino-Realm (283) - Se o Destino-Host estiver ausente, roteia com base no realm
- O DRA seleciona um par conectado que anuncia suporte para o realm alvo
- O balanceamento de carga é aplicado quando múltiplos pares correspondem ao realm
- O roteamento baseado em realm permite flexibilidade entre múltiplos hosts
Application-Id - Os pares são filtrados por aplicações de Diâmetro suportadas
- Apenas pares que anunciam suporte para o Application-Id da mensagem são considerados
- Baseado na Troca de Capacidades (CER/CEA) durante o estabelecimento da conexão do par
- Veja IDs de Aplicação 3GPP Comuns para referência

Roteamento de Respostas

Pacotes de resposta usam um mecanismo de roteamento fundamentalmente diferente do das requisições:

Roteamento baseado em sessão: Pacotes de resposta sempre seguem o caminho reverso da requisição
Preservação do ID de Ponto a Ponto: O Identificador de Ponto a Ponto permanece inalterado em todos os saltos
Roteamento Salto a Salto: O DRA usa o Identificador Salto a Salto para manter o estado de roteamento (muda em cada salto)
Sem avaliação de regras: O DRA não avalia regras de roteamento ou conteúdos de AVP para respostas
Correlação com estado: Tabelas de roteamento internas rastreiam qual par enviou cada requisição

Por que as respostas não são roteadas por módulos avançados:

O roteamento de respostas é determinístico e deve retornar ao par de origem
O protocolo Diâmetro exige que as respostas sigam o caminho de requisição estabelecido
As decisões de roteamento para respostas são feitas com base no contexto da requisição original, não no conteúdo da resposta
Isso garante um gerenciamento de sessão adequado e previne loops de roteamento

Veja Seção 6.2 da RFC 6733 para detalhes sobre o roteamento de mensagens de resposta.

Seleção de Pares

Quando múltiplos pares correspondem aos critérios de roteamento, o peer_selection_algorithm configurado determina a seleção:

:random - Seleciona aleatoriamente entre os pares disponíveis (padrão)
:failover - Sempre seleciona o primeiro par na lista (baseado em prioridade)
Os pares devem estar em estado conectado para serem selecionados
Pares desconectados ou fora do ar são automaticamente excluídos

Limitações do Roteamento Padrão

Sem regras de roteamento personalizadas baseadas em valores de AVP (por exemplo, padrões de IMSI)
Sem tradução de realm ou modificação de AVP
Não é possível roteamento baseado no par de origem
Controle limitado sobre a distribuição de tráfego

Os módulos Roteamento Avançado e Transformação Avançada estendem esse comportamento padrão com capacidades de roteamento baseado em regras e manipulação de pacotes.

Configuração Base do DRA

O DRA requer uma configuração base que define sua identidade, configurações de rede e conexões de pares. Essa configuração estabelece a base para todas as operações de roteamento.

Estrutura da Configuração

%{
  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: [
    # Configurações de pares...
  ]
}

Parâmetros de Identidade do DRA

Parâmetro	Tipo	Descrição
`host`	String	A Identidade de Diâmetro do DRA (nome de domínio totalmente qualificado)
`realm`	String	O realm de Diâmetro do DRA
`product_name`	String	Nome do produto anunciado nas mensagens CER/CEA
`vendor_id`	Inteiro	Vendor-ID conforme definido na Seção 5.3.3 da RFC 6733 (10415 = 3GPP)

Configurações de Rede

Parâmetro	Tipo	Descrição
`listen_ip`	String	Endereço IP que o DRA escuta para conexões de entrada
`listen_port`	Inteiro	Porta TCP/SCTP para conexões de Diâmetro (padrão: 3868)
`service_name`	Átomo	Identificador de serviço interno do Erlang
`request_timeout`	Inteiro	Tempo limite em milissegundos para pares de requisição/resposta (padrão: 5000)

Configurações de Seleção de Pares

Parâmetro	Tipo	Descrição
`peer_selection_algorithm`	Átomo	Algoritmo de balanceamento de carga: `:random` (seleção aleatória) ou `:failover` (prioridade para o primeiro par)
`allow_undefined_peers_to_connect`	Booleano	Permitir conexões de pares não configurados (padrão: `false`)
`log_unauthorized_peer_connection_attempts`	Booleano	Registrar tentativas de conexão de pares não autorizados

Configuração de Pares

Cada par na lista peers define uma conexão de Diâmetro:

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

Parâmetros de Par

Parâmetro	Tipo	Descrição
`host`	String	A Identidade de Diâmetro do par (FQDN) - deve corresponder exatamente para roteamento
`realm`	String	O realm de Diâmetro do par
`ip`	String	Endereço IP do par para conexão
`port`	Inteiro	Porta de Diâmetro do par (tipicamente 3868)
`transport`	Átomo	Protocolo de transporte: `:diameter_tcp` ou `:diameter_sctp`
`tls`	Booleano	Habilitar criptografia TLS (se `true`, tipicamente usar porta 3869)
`initiate_connection`	Booleano	`true`: DRA conecta ao par, `false`: DRA espera o par conectar

Modos de Conexão

Iniciar Conexão (initiate_connection: true)

DRA atua como cliente de Diâmetro
DRA inicia a conexão TCP/SCTP com o par
Usado para conectar ao HSS, PCRF ou outros sistemas de backend
DRA tentará reconectar se o par estiver inacessível

Aceitar Conexão (initiate_connection: false)

DRA atua como servidor de Diâmetro
DRA espera o par conectar
Usado para conexões MME, SGSN, P-GW
O par deve estar na configuração ou allow_undefined_peers_to_connect: true

Exemplo de Configuração

%{
  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 - espera o MME conectar
    %{
      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 inicia a conexão
    %{
      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 com TLS - DRA inicia conexão segura
    %{
      host: "pcrf01.mvno.example.com",
      realm: "mvno.example.com",
      ip: "10.100.3.22",
      port: 3869,
      transport: :diameter_tcp,
      tls: true,
      initiate_connection: true
    }
  ]
}

Notas Importantes

Correspondência de Nome de Host: Os nomes de host dos pares nas regras de Roteamento Avançado devem corresponder exatamente ao valor host configurado aqui (sensível a maiúsculas e minúsculas)
Troca de Capacidades: Na conexão, os pares trocam aplicações suportadas via mensagens CER/CEA
Suporte a Aplicações: O DRA anuncia todas as aplicações 3GPP suportadas (veja IDs de Aplicação 3GPP Comuns)
Vendor-ID 10415: Valor padrão para aplicações 3GPP
Tempo Limite de Requisição: Afeta o TTL das Métricas Estendidas (tempo limite + 5 segundos)
Seleção de Pares: Quando múltiplos pares correspondem aos critérios de roteamento, o peer_selection_algorithm determina qual é escolhido

Considerações de Segurança

Defina allow_undefined_peers_to_connect: false em produção
Habilite log_unauthorized_peer_connection_attempts: true para monitoramento de segurança
Certifique-se de que as regras de firewall correspondam às configurações de listen_ip e listen_port
Valide os certificados dos pares ao usar TLS

Tabelas de Referência

IDs de Aplicação 3GPP Comuns

Application-Id	Interface	Descrição
16777251	S6a/S6d	Autenticação e dados de assinatura MME/SGSN para HSS
16777252	S13/S13'	Verificação de identidade de equipamento MME para EIR
16777238	Gx	Controle de política e cobrança PCEF para PCRF
16777267	S9	Política de roaming do PCRF doméstico para o PCRF visitado
16777272	Sy	Vinculação de sessão PCRF para OCS
16777216	Cx	Registro IMS I-CSCF/S-CSCF para HSS
16777217	Sh	Dados do usuário IMS AS para HSS
16777236	SLg	Serviços de localização MME/SGSN para GMLC
16777291	SLh	Informações de assinante de localização GMLC para HSS
16777302	S6m	MTC-IWF para HSS/HLR para dispositivos M2M
16777308	S6c	Roteamento de SMS HSS para SMS-SC/IP-SM-GW
16777343	S6t	Eventos de monitoramento SCEF para HSS
16777334	Rx	Autorização de mídia AF para PCRF

Códigos AVP Comuns

Código	Nome AVP	Tipo	Uso
1	User-Name	UTF8String	Identificador do assinante (IMSI em 3GPP)
264	Origin-Host	DiameterIdentity	Nome do host do par de origem
268	Result-Code	Unsigned32	Código de resultado padrão
283	Destination-Realm	DiameterIdentity	Realm alvo
293	Destination-Host	DiameterIdentity	Host alvo (opcional)
296	Origin-Realm	DiameterIdentity	Realm de origem
297	Experimental-Result	Grouped	Código de resultado específico do fornecedor

Códigos de Comando Comuns

Os códigos de comando são parte do cabeçalho da mensagem de Diâmetro, não dos AVPs:

Código	Nome do Comando	Descrição
257	CER/CEA	Requisição/Resposta de Troca de Capacidades
258	RAR/RAA	Requisição/Resposta de Reautenticação
274	ASR/ASA	Requisição/Resposta de Abortamento de Sessão
275	STR/STA	Requisição/Resposta de Terminação de Sessão
280	DWR/DWA	Requisição/Resposta de Monitoramento de Dispositivo
282	DPR/DPA	Requisição/Resposta de Desconexão de Par
316	ULR/ULA	Requisição/Resposta de Atualização de Localização (S6a)
317	CLR/CLA	Requisição/Resposta de Cancelamento de Localização (S6a)
318	AIR/AIA	Requisição/Resposta de Informação de Autenticação (S6a)
321	PUR/PUA	Requisição/Resposta de Purga de UE (S6a)

Módulo de Roteamento Avançado

O módulo de Roteamento Avançado fornece capacidades de roteamento de mensagens baseadas em regras flexíveis, com suporte para condições de correspondência complexas.

Importante: Este módulo avalia apenas pacotes de requisição de Diâmetro de entrada (não pacotes de resposta). Pacotes de resposta seguem o roteamento de sessão estabelecido de volta ao par de origem - veja Roteamento de Respostas para detalhes.

Configuração

Habilite o módulo e defina regras de roteamento em sua configuração:

dra_module_advanced_routing:
  enabled: True
  rules:
    - rule_name: <identificador_da_regra>
      match: <escopo_de_correspondencia>
      filters: [<lista_de_filtros>]
      route:
        peers: [<lista_de_pares>]

Parâmetros

Parâmetro	Descrição
`enabled`	Defina como `True` para ativar o módulo
`rule_name`	Identificador único para a regra de roteamento
`match`	Como os filtros são combinados: `:all` (lógica AND - todos os filtros devem corresponder), `:any` (lógica OR - pelo menos um filtro deve corresponder), `:none` (lógica NOR - nenhum filtro pode corresponder)
`filters`	Lista de condições de filtro (veja Filtros Disponíveis)
`route.peers`	Lista de nomes de host de pares alvo (devem ser pares de Diâmetro pré-configurados em sua configuração do DRA), OU use o destino especial `:destination_host` para roteamento baseado no AVP Destino-Host (293)

Importante: Os pares especificados em route.peers devem ser:

Definidos na configuração de pares de Diâmetro do DRA
O nome do host exato como configurado (sensível a maiúsculas e minúsculas)
Atualmente conectados para que o roteamento seja bem-sucedido (pares desconectados são ignorados)

Filtros Disponíveis

Filtros Padrão

Disponíveis tanto no Roteamento Avançado quanto na Transformação Avançada:

:application_id - Correspondência do ID de aplicação de Diâmetro (veja referência de ID de Aplicação)
- Valor único: {:application_id, 16777251} (S6a/S6d)
- Vários valores: {:application_id, [16777251, 16777252]} (S6a ou S6b)
:command_code - Correspondência do código de comando de Diâmetro
- Valor único: {:command_code, 318} (requisição AIR)
- Vários valores: {:command_code, [317, 318]} (ULR ou AIR)
:avp - Correspondência do valor de AVP (veja referência de código AVP)
- Correspondência exata: {:avp, {296, "epc.mnc001.mcc001.3gppnetwork.org"}}
- Correspondência regex: {:avp, {1, ~r"999001.*"}}
- Múltiplos padrões: {:avp, {1, ["505057001313606", ~r"999001.*", ~r"505057.*"]}}
- Qualquer valor (verificação de presença): {:avp, {264, :any}}

Filtro Específico de Roteamento

Disponível apenas no Roteamento Avançado:

:via_peer - Correspondência do par de onde a requisição foi recebida
- Um único par: {:via_peer, "omnitouch-lab-dra01.epc.mnc001.mcc001.3gppnetwork.org"}
- Múltiplos pares: {:via_peer, ["omnitouch-lab-dra01.epc.mnc001.mcc001.3gppnetwork.org", "omnitouch-lab-dra02.epc.mnc001.mcc001.3gppnetwork.org"]}
- Qualquer par: {:via_peer, :any}

Filtros Específicos de Transformação

Disponíveis apenas na Transformação Avançada:

:to_peer - Correspondência em um par de destino predeterminado (apenas pacotes de requisição)
- Um único par: {:to_peer, "dra01.omnitouch.com.au"}
- Múltiplos pares: {:to_peer, ["dra01.omnitouch.com.au", "dra02.omnitouch.com.au"]}
:from_peer - Correspondência do par que enviou a resposta (apenas pacotes de resposta)
- Um único par: {:from_peer, "hss-01.example.com"}
- Múltiplos pares: {:from_peer, ["hss-01.example.com", "hss-02.example.com"]}
:packet_type - Correspondência da direção do pacote
- Requisição: {:packet_type, :request}
- Resposta: {:packet_type, :answer}

Notas Importantes sobre Filtros

Filtros AVP: Recomendados apenas para AVPs simples (User-Name, Origin-Host, Destination-Realm, etc.)
- AVPs agrupados não são suportados e não corresponderão
- Valores binários complexos não são suportados
- Use o formato: {:avp, {code, value}}
Operadores de Lista: Suportados para todos os valores de filtro, exceto :packet_type
- Quando uma lista é usada, aplica-se lógica OR dentro da lista
- Exemplo: {:command_code, [317, 318]} corresponde ao código de comando 317 OU 318
Valores Especiais:
- :any - Corresponde a qualquer valor (verifica a presença do AVP)
- Exemplo: {:avp, {264, :any}} corresponde se o AVP Origin-Host existir com qualquer valor

Exemplos de Roteamento

Exemplo 1: Roteamento via Par

Roteie mensagens com base em qual DRA elas chegaram:

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]

Como funciona: Roteia o tráfego S6a que chega através de pares DRA específicos para nós HSS locais.

Exemplo 2: Roaming de Entrada com Correspondência de Padrões

Roteie o tráfego de roaming com base em padrões de 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]

Como funciona: Roteia mensagens S6a de um Realm de Origem específico com padrões de IMSI correspondentes para pares DRA designados.

Exemplo 3: Roteamento Dinâmico com :destination_host

Roteie para o valor do AVP Destination-Host na mensagem:

dra_module_advanced_routing:
  enabled: True
  rules:
    - rule_name: route_to_specified_destination_host
      match: ":all"
      filters:
        - '{:avp, {1, [~r"90199.*"]}}'  # Corresponde ao padrão de IMSI
      route: :destination_host

Como funciona:

Quando os filtros correspondem, roteia para o par especificado no AVP Destination-Host (293)
Se o AVP Destination-Host estiver ausente, a correspondência é considerada uma falha e recai para o roteamento normal
Útil para honrar o roteamento quando o remetente especifica o destino exato

Módulo de Transformação Avançada

O módulo de Transformação Avançada permite a modificação dinâmica de AVPs de mensagens de Diâmetro com base em critérios de correspondência. Veja Processamento de Regras para detalhes sobre como as regras são avaliadas.

Configuração

Habilite o módulo e defina regras de transformação:

dra_module_advanced_transform:
  enabled: True
  rules:
    - rule_name: <identificador_da_regra>
      match: <escopo_de_correspondencia>
      filters: [<lista_de_filtros>]
      transform:
        action: <acao_de_transformacao>
        avps: [<modificações_de_avp>]

Parâmetros

Parâmetro	Descrição
`enabled`	Defina como `True` para ativar o módulo
`rule_name`	Identificador único para a regra de transformação
`match`	Como os filtros são combinados: `:all` (lógica AND), `:any` (lógica OR), `:none` (lógica NOR) - veja Lógica de Filtro
`filters`	Lista de condições de filtro (veja Filtros Disponíveis)
`transform.action`	Tipo de transformação (`:edit`, `:remove` ou `:overwrite`)
`transform.avps`	Lista de modificações de AVP a serem aplicadas (veja referência de código AVP)

Ações de Transformação

Pacotes de Requisição (Requisições de Diâmetro)

:edit - Modificar valores de AVP existentes
- Apenas modifica AVPs que existem na mensagem
- Se o AVP não existir, nenhuma alteração é feita
:remove - Remover AVPs da mensagem
:overwrite - Substituir estruturas inteiras de AVP
- Requer o parâmetro dictionary especificando o dicionário de Diâmetro (por exemplo, :diameter_gen_3gpp_s6a)

Pacotes de Resposta (Respostas de Diâmetro)

:remove - Remover AVPs da mensagem
:overwrite - Substituir estruturas inteiras de AVP
- Requer o parâmetro dictionary

Importante: Se nenhuma regra corresponder, o pacote é passado através de forma transparente sem quaisquer transformações.

Sintaxe de Modificação de AVP

Modificação padrão:

{:avp, {<código>, <novo_valor>}} - Define o AVP para um novo valor

Removendo AVPs:

{:avp, {<código>, :any}} - Remove o AVP pelo ID (remove independentemente do valor atual)
Nota: Remover com base no avp_id é suportado; remover com base no conteúdo do AVP não é suportado

Sobrescrever com dicionário:

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

Exemplos de Transformação

Exemplo 1: Reescrita de Realm de Destino Baseada em Par

Reescreva o Destination-Realm com base em onde a mensagem está sendo roteada:

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"}}'

Como funciona: Quando requisições S6a são roteadas para pares DRA específicos e correspondem ao padrão de IMSI, reescreve o Destination-Realm para a rede do Operador X.

Exemplo 2: Roteamento de Múltiplos Operadores com Transformações

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"}}'

Como funciona: Roteia diferentes faixas de assinantes IMSI para os realms de rede apropriados com base em padrões de IMSI. A primeira regra correspondente vence (veja Ordem de Execução).

Exemplo 3: Reescrita de Realm para 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"]}}'  # Correspondência exata de IMSI
      transform:
        action: ":edit"
        avps:
          - '{:avp, {283, "epc.mnc001.mcc001.3gppnetwork.org"}}'

Como funciona: Transforma o Destination-Realm para um assinante específico de MVNO para sua rede central hospedada.

Exemplo 4: Transformação Apenas de Requisição com Filtro de Tipo de Pacote

Transforme apenas pacotes de requisição (não respostas):

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 deve existir com qualquer valor
      transform:
        action: ":edit"
        avps:
          - '{:avp, {1, "999999000000002"}}'

Como funciona:

Corresponde apenas pacotes de requisição S6a AIR requisições (não pacotes de resposta)
Verifica se o User-Name (AVP 1) é igual a "999999000000001"
Verifica se o Origin-Host (AVP 264) existe com qualquer valor
Reescreve o User-Name para "999999000000002"
Se o AVP não existir, nenhuma alteração é feita

Exemplo 5: Remover AVP

Remova um AVP específico das mensagens:

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}}'  # Remove User-Name independentemente do valor

Como funciona: Remove o AVP User-Name (código 1) de todas as mensagens S6a, independentemente de seu valor atual.

Exemplo 6: Sobrescrever AVP Agrupado em Pacotes de Resposta

Modifique AVPs agrupados complexos em pacotes de resposta usando a ação :overwrite com suporte a dicionário:

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 (Resposta de Atualização de Localização)
        - '{:packet_type, :answer}'           # Apenas pacotes de resposta
        - '{:avp, {296, "epc.mnc001.mcc001.3gppnetwork.org"}}'  # Realm de Origem
      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, [], [], []}],
                  [], [], [], [], [], [], [], [], [], [], [], [], [], [], []}
              ], []}
            }}'

Como funciona:

Corresponde a pacotes S6a de Resposta de Atualização de Localização (ULA) de um Realm de Origem específico
Usa a ação :overwrite para substituir todo o AVP agrupado APN-Configuration-Profile
Requer o parâmetro dictionary para codificar corretamente estruturas de AVP agrupadas complexas
Adiciona três configurações de APN: "internet" (contexto 1), "ims" (contexto 2) e "sos" (contexto 3)
Cada APN inclui perfis de QoS, limites de largura de banda (AMBR) e configurações de tipo PDN
A transformação garante que o APN de serviços de emergência (SOS) seja provisionado para todos os assinantes desse realm

Quando usar :overwrite com dicionário:

Modificando AVPs agrupados com estruturas aninhadas (como APN-Configuration-Profile)
Adicionando ou reestruturando dados de assinatura complexos 3GPP
Quando a ação :edit não pode lidar com a complexidade do AVP
O dicionário deve corresponder à aplicação de Diâmetro (:diameter_gen_3gpp_s6a para S6a, etc.)

Notas importantes:

:overwrite substitui todo o AVP, não apenas campos individuais
A estrutura do AVP deve corresponder exatamente à definição do dicionário
Estruturas incorretas causarão falhas de codificação e pacotes descartados
Este é um recurso avançado - valide minuciosamente primeiro em um ambiente de teste

Casos de Uso

Suporte a MVNO: Roteie o tráfego de operadores virtuais para redes centrais hospedadas
Migração de Rede: Redirecione gradualmente assinantes para nova infraestrutura
Tradução de Realm: Converta entre diferentes esquemas de nomenclatura para parceiros de roaming
Multi-tenancy: Isolar populações de assinantes por realm
Roteamento de Operadora: Direcione o tráfego para as redes corretas de operadoras com base em faixas de IMSI

Processamento de Regras

Aplica-se tanto aos módulos Roteamento Avançado quanto Transformação Avançada.

Ordem de Execução

As regras são avaliadas na ordem de cima para baixo conforme definido na configuração
Os filtros dentro de uma regra são avaliados com base no parâmetro match (:all, :any ou :none)
A primeira regra correspondente vence - regras subsequentes não são avaliadas
Se nenhuma regra corresponder, o comportamento padrão de roteamento/passageiro é usado

Lógica de Filtro

O parâmetro match determina como os filtros são combinados:

match: :all (Lógica AND)

Todos os filtros devem corresponder para que a regra tenha sucesso.

Exemplo: Com 3 filtros, filtro1 E filtro2 E filtro3 devem todos ser verdadeiros.

match: :any (Lógica OR)

Pelo menos um filtro deve corresponder para que a regra tenha sucesso.

Exemplo: Com 3 filtros, filtro1 OU filtro2 OU filtro3 (qualquer um passa).

match: :none (Lógica NOR)

Nenhum filtro pode corresponder para que a regra tenha sucesso (correspondência inversa).

Exemplo: Com 3 filtros, NÃO filtro1 E NÃO filtro2 E NÃO filtro3 (todos devem falhar).

Notas Adicionais:

Ao usar operadores de lista dentro de um valor de filtro (por exemplo, {:avp, {1, ["valor1", "valor2"]}}), os valores usam lógica OR (qualquer pode corresponder).

Padrões de Expressão Regular

Use a sintaxe ~r"padrão" para correspondência regex:

~r"999001.*" - Corresponde a IMSI começando com 999001
~r"^310[0-9]{3}.*" - Corresponde a IMSI com padrões MNC específicos
~r".*teste$" - Corresponde a valores terminando com "teste"

Melhores Práticas

Especificidade: Ordene regras da mais específica para a mais geral
Desempenho: Coloque as correspondências mais comuns primeiro para reduzir a sobrecarga de processamento
Teste: Valide padrões regex antes da implantação
Documentação: Use valores descritivos para rule_name para clareza operacional
Monitoramento: Acompanhe taxas de correspondência de regras para verificar o comportamento esperado

Módulo de Métricas Estendidas

O módulo de Métricas Estendidas fornece capacidades avançadas de telemetria e análise para analisar padrões de tráfego de Diâmetro além das métricas padrão.

Configuração

Habilite o módulo e configure tipos específicos de métricas:

module_extended_metrics:
  enabled: true
  attach_attempt_reporting_enabled: true

Parâmetros

Parâmetro	Descrição
`enabled`	Defina como `true` para ativar o módulo de métricas estendidas
`attach_attempt_reporting_enabled`	Habilitar rastreamento e relatório de tentativas de conexão LTE (S6a AIR/AIA)

Métricas Disponíveis

Rastreamento de Tentativas de Conexão

Rastreia tentativas de conexão de assinantes LTE monitorando pares de mensagens de Requisição de Informação de Autenticação (AIR) e Resposta (AIA):

Medição: attach_attempt_count

Campos:

imsi - O IMSI do assinante (do AVP User-Name - veja códigos AVP)

Tags:

origin_host - O par que originou a requisição de conexão
result_code - O código de resultado do Diâmetro da resposta do HSS

Como funciona:

Quando uma AIR (código de comando 318, aplicação S6a 16777251 - veja IDs de Aplicação) é recebida, o módulo extrai:
- ID de Ponto a Ponto para correlação de requisição/resposta
- IMSI (AVP User-Name código 1)
- Origin-Host (AVP código 264)
Os metadados da requisição são armazenados no ETS com TTL
Quando a AIA correspondente é recebida, o módulo:
- Correlaciona usando o ID de Ponto a Ponto
- Extrai o código de resultado (AVP 268 ou AVP de resultado experimental 297)
- Emite a métrica com IMSI, origin host e código de resultado

Casos de Uso

Análise da Taxa de Sucesso de Conexão - Acompanhe tentativas de conexão bem-sucedidas vs falhadas por código de resultado
Solução de Problemas em Nível de IMSI - Identifique assinantes que estão enfrentando falhas de conexão
Monitoramento de Desempenho de Rede - Monitore padrões de tentativas de conexão por origem (MME/SGSN)
Análise de Roaming - Analise taxas de sucesso de conexão de roaming de entrada

Integração

As métricas estendidas são exportadas via integração com InfluxDB:

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

Os códigos de resultado são códigos padrão do Diâmetro:

2001 - Sucesso (SUCESSO_DIAMETRO)
5001 - Falha de autenticação (AUTENTICAÇÃO_DIAMETRO_REJEITADA)
5004 - AVP de Diâmetro não suportado
Veja a RFC 6733 para a lista completa de códigos de resultado

Notas Importantes

As métricas de tentativas de conexão rastreiam apenas pares AIR/AIA S6a (Application-Id 16777251, Command-Code 318)
Os metadados da requisição expiram com base no tempo limite de requisição configurado + 5 segundos
O processamento de métricas é assíncrono (processo gerado) para evitar bloqueio do fluxo de mensagens
O módulo opera de forma independente dos módulos de roteamento e transformação

Solução de Problemas

Regra Não Correspondendo

Verifique se todas as condições de filtro estão corretas
Verifique se os códigos AVP correspondem à sua aplicação de Diâmetro (veja referência de código AVP)
Teste padrões regex de forma independente (veja Padrões de Expressão Regular)
Certifique-se de que o tipo de mensagem corresponda ao escopo match (veja Lógica de Filtro)
Revise Filtros Disponíveis para garantir que você está usando o tipo de filtro correto para seu módulo

Roteamento Inesperado

Revise a ordenação das regras - a primeira correspondência vence
Verifique se os nomes dos pares estão corretos e acessíveis
Verifique se há regras conflitantes com filtros sobrepostos
Confirme o comportamento de Roteamento Padrão de Diâmetro quando nenhuma regra corresponder

Transformação Não Aplicada

Confirme se os códigos AVP estão corretos para seu caso de uso (veja referência de código AVP)
Para a ação :edit: Verifique se o AVP existe na mensagem (edição não criará novos AVPs)
Verifique se os filtros correspondem ao fluxo de mensagem pretendido
Verifique o filtro de tipo de pacote se usado (:request vs :answer)
Certifique-se de que a ação é suportada para o tipo de pacote (:edit só funciona em requisições - veja Ações de Transformação)
Revise Processamento de Regras para a ordem de execução

Índice​

Visão Geral da Arquitetura do DRA​

Roteamento de Diâmetro Padrão​

Roteamento de Requisições​

Roteamento de Respostas​

Seleção de Pares​

Limitações do Roteamento Padrão​

Configuração Base do DRA​

Estrutura da Configuração​

Parâmetros de Identidade do DRA​

Configurações de Rede​

Configurações de Seleção de Pares​

Configuração de Pares​

Parâmetros de Par​

Modos de Conexão​

Exemplo de Configuração​

Notas Importantes​

Considerações de Segurança​

Tabelas de Referência​

IDs de Aplicação 3GPP Comuns​

Códigos AVP Comuns​

Códigos de Comando Comuns​

Módulo de Roteamento Avançado​

Configuração​

Parâmetros​

Filtros Disponíveis​

Filtros Padrão​

Filtro Específico de Roteamento​

Filtros Específicos de Transformação​

Notas Importantes sobre Filtros​

Exemplos de Roteamento​

Exemplo 1: Roteamento via Par​

Exemplo 2: Roaming de Entrada com Correspondência de Padrões​

Exemplo 3: Roteamento Dinâmico com :destination_host​

Módulo de Transformação Avançada​

Configuração​

Parâmetros​

Ações de Transformação​

Pacotes de Requisição (Requisições de Diâmetro)​

Pacotes de Resposta (Respostas de Diâmetro)​

Sintaxe de Modificação de AVP​

Exemplos de Transformação​

Exemplo 1: Reescrita de Realm de Destino Baseada em Par​

Exemplo 2: Roteamento de Múltiplos Operadores com Transformações​

Exemplo 3: Reescrita de Realm para MVNO​

Exemplo 4: Transformação Apenas de Requisição com Filtro de Tipo de Pacote​

Exemplo 5: Remover AVP​

Exemplo 6: Sobrescrever AVP Agrupado em Pacotes de Resposta​

Casos de Uso​

Processamento de Regras​

Ordem de Execução​

Lógica de Filtro​

match: :all (Lógica AND)​

match: :any (Lógica OR)​

match: :none (Lógica NOR)​

Padrões de Expressão Regular​

Melhores Práticas​

Módulo de Métricas Estendidas​

Configuração​

Parâmetros​

Métricas Disponíveis​

Rastreamento de Tentativas de Conexão​

Casos de Uso​

Integração​

Notas Importantes​

Solução de Problemas​

Regra Não Correspondendo​

Roteamento Inesperado​

Transformação Não Aplicada​

Índice

Visão Geral da Arquitetura do DRA

Roteamento de Diâmetro Padrão

Roteamento de Requisições

Roteamento de Respostas

Seleção de Pares

Limitações do Roteamento Padrão

Configuração Base do DRA

Estrutura da Configuração

Parâmetros de Identidade do DRA

Configurações de Rede

Configurações de Seleção de Pares

Configuração de Pares

Parâmetros de Par

Modos de Conexão

Exemplo de Configuração

Notas Importantes

Considerações de Segurança

Tabelas de Referência

IDs de Aplicação 3GPP Comuns

Códigos AVP Comuns

Códigos de Comando Comuns

Módulo de Roteamento Avançado

Configuração

Parâmetros

Filtros Disponíveis

Filtros Padrão

Filtro Específico de Roteamento

Filtros Específicos de Transformação

Notas Importantes sobre Filtros

Exemplos de Roteamento

Exemplo 1: Roteamento via Par

Exemplo 2: Roaming de Entrada com Correspondência de Padrões

Exemplo 3: Roteamento Dinâmico com :destination_host

Módulo de Transformação Avançada

Configuração

Parâmetros

Ações de Transformação

Pacotes de Requisição (Requisições de Diâmetro)

Pacotes de Resposta (Respostas de Diâmetro)

Sintaxe de Modificação de AVP

Exemplos de Transformação

Exemplo 1: Reescrita de Realm de Destino Baseada em Par

Exemplo 2: Roteamento de Múltiplos Operadores com Transformações

Exemplo 3: Reescrita de Realm para MVNO

Exemplo 4: Transformação Apenas de Requisição com Filtro de Tipo de Pacote

Exemplo 5: Remover AVP

Exemplo 6: Sobrescrever AVP Agrupado em Pacotes de Resposta

Casos de Uso

Processamento de Regras

Ordem de Execução

Lógica de Filtro

match: :all (Lógica AND)

match: :any (Lógica OR)

match: :none (Lógica NOR)

Padrões de Expressão Regular

Melhores Práticas

Módulo de Métricas Estendidas

Configuração

Parâmetros

Métricas Disponíveis

Rastreamento de Tentativas de Conexão

Casos de Uso

Integração

Notas Importantes

Solução de Problemas

Regra Não Correspondendo

Roteamento Inesperado

Transformação Não Aplicada