Configure o CDR no CUCM versão 11.5

Introduction

Este documento descreve como configurar o Call Detail Routing (CDR) no Cisco Unified Communications Manager (CUCM) versão 11.5.

Prerequisites

Requirements

A Cisco recomenda ter conhecimento deste tópico:

• Cisco Unified Communications Manager (CUCM) versão 11.5

Componentes Utilizados

As informações neste documento são baseadas na versão 11.5 do CUCM.

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.

Informações de Apoio 

O CUCM produz dois tipos de registros, que armazenam o histórico de chamadas e as informações de diagnóstico:

• Registros de detalhes de chamadas (CDRs) - Os registros de dados contêm informações sobre cada chamada processada pelo CallManager.
• Registros de gerenciamento de chamadas (CMRs - Call Management Records) - Os registros de dados contêm informações de qualidade de serviço (QoS - Quality of Service) ou de diagnóstico sobre a chamada, também chamados de registros de diagnóstico.

Os CDRs e os CMRs juntos são chamados de dados CDR. Os dados CDR fornecem um registro de todas as chamadas feitas ou recebidas pelos usuários do sistema CallManager. Os dados CDR são úteis principalmente para gerar os registros de cobrança; no entanto, ele também pode ser usado para rastrear a atividade das chamadas, diagnosticar certos tipos de problemas e o plano de capacidade.

Os CDRs contêm informações sobre a origem da chamada, o destino da chamada, a data e a hora em que a chamada foi iniciada, a hora em que ela realmente se conectou e a hora em que ela terminou. Uma chamada é considerada iniciada ou originada quando o chamador sai do gancho. A chamada é considerada encerrada quando o chamador ou o chamador ficam no gancho. Os CMRs contêm informações sobre a quantidade de dados enviados e recebidos, instabilidade, latência e pacotes perdidos.

Arquitetura

Serviços necessários

CallManager

• O CallManager pode ser ativado em qualquer nó no cluster.
  
  
• Ele processa chamadas e grava dados CDR e CMR em arquivos simples.
  
  
• Os arquivos simples são gerados em uma frequência determinada pelo CDR File Time Interval pavilhão sob Enterprise Parameters.

Agente CDR

• O Agente CDR é executado como um serviço de rede em cada nó em um cluster (isso inclui o Editor).
  
  
• Ele pesquisa o diretório local para CDR e os arquivos simples CMR a cada seis segundos.
  
  
• Se encontrar novos arquivos simples CDR e CMR, ele envia os arquivos simples CDR e CMR desse nó para o nó Repositório CDR (Publisher).
  
  
• Após a transferência bem-sucedida, o sistema exclui a cópia local do arquivo.

CDR Repository Manager

• O Gerenciador de Repositório CDR é executado como um Serviço de Rede em todos os nós em um cluster. No entanto, somente o CDR Repository Manager no Publisher executa qualquer ação. Em todos os outros nós, o serviço simplesmente é iniciado, mas depois vai para a espera.
  
  
• Cria a estrutura de diretórios utilizada pelos serviços CAR.
  
  
• Ele gerencia os arquivos simples recebidos de outros nós. Quando o arquivo chega no nó Repositório CDR, o Gerenciador de Repositório CDR o detecta. O sistema arquiva o arquivo em um diretório dedicado à data indicada pelo carimbo de data e hora colocado no nome do arquivo quando ele foi criado.
  
  
• Envia arquivos CDR para até três servidores de cobrança externos.
  
  
• Ele mantém arquivos CDR por um certo número de dias, até 30 dias.
  
  
• Verifica periodicamente o uso do disco e exclui arquivos antigos. Os limiares são configurados por meio do Gerenciamento CDR (abordado posteriormente na apresentação).
  
  
• Ele gera um alarme se a entrega falhou ou se o uso do disco for muito alto.

Agendador CAR

• O Agendador CAR é executado como um Serviço de Rede em todos os nós de um cluster. No entanto, somente o serviço do CAR Scheduler no Publisher executa qualquer ação. Em todos os outros nós, o serviço simplesmente é iniciado, mas depois vai para a espera.
  
  
• Com base na programação de carregamento do CDR, ele acessa os arquivos CDR/CMR na estrutura de diretório que o serviço CDR Repository Manager cria, processa esses arquivos e insere as informações do CDR no banco de dados do CAR.
  
  
• O tamanho máximo do banco de dados CAR é 6 Gb (não configurável). O Agendador CAR remove os dados da base de dados CAR se exceder 6 Gb ou se o número de registros exceder 2 milhões. O limite de dois milhões de registros inclui dados em ambos tbl_billing_data e tbl_billing_error.

Serviço Web CAR

• O serviço Web CAR só pode ser ativado no Publisher.
  
  
• Ele é executado como um serviço de recursos (Control Center Feature Services).
  
  
• Ele deve estar ativo para acessar a ferramenta CDR Analysis and Reporting (CAR).

Serviço CDRonDemand

• O CDRonDemand Service é um serviço baseado em SOAP (Simple Object Access Protocol)/HTTPS executado no nó do repositório CDR (ou seja, Publisher).
  
  
• Ele recebe solicitações SOAP para listas de nomes de arquivos CDR de um servidor de terceiros com base em um intervalo de tempo especificado pelo usuário (até um máximo de uma hora) e retorna todas as listas que se ajustam à duração especificada pela solicitação.

O CDR onDemand Service também pode lidar com solicitações para entregar um arquivo CDR específico a um destino especificado por meio do (s)FTP. O sistema pode ativar o serviço CDR onDemand no nó Repositório CDR, pois ele precisa acessar os arquivos CDR no repositório.

Há dois parâmetros relevantes em System > Enterprise Parameters que são usados para limitar solicitações do servidor de terceiros:

• Consultas de CDRonDemandget_file permitidas por minuto (Mín:1, Máx:20, Padrão:10)
• Consultas CDRonDemandget_file_list permitidas por minuto (Mín:1, Máx:40, Padrão:20)

Estrutura de diretório do CDR Repository Manager

A Estrutura de Diretório do Gerenciador de Repositório CDR, conforme descrito aqui, existe apenas no Editor.

Tudo sob /var/log/active/cm/cdr_repository

admin:file list activelog /cm/cdr_repository
<dir>   car
<dir>   destination1
<dir>   destination2
<dir>   destination3
<dir>   preserve
<dir>   processed
<dir>   tmp
<dir>   trans
dir count = 8, file count = 0
admin:

trans - Os arquivos são recebidos do nó CM.

tmp - Os arquivos aguardam para serem processados.

preserve/yyyymmdd - Arquivos a serem enviados e/ou carregados pelo CAR

processed/yyyymmdd - Arquivos enviados com êxito a todos os destinos e carregados pelo CAR (se o CAR não estiver ativado e nenhum servidor de cobrança estiver configurado, os arquivos serão colocados aqui diretamente).

destinationX/yyyymmdd - Contém links simbólicos para arquivos preservados. O serviço CDR Repository Manager usa esses links virtuais para determinar quais arquivos precisam ser transferidos para o servidor de cobrança.

car/yyyymmdd - Contém links simbólicos para arquivos preservados. O serviço do Agendador CAR usa esses links virtuais para determinar os arquivos que precisam ser processados pelo carregador CDR.

Entender os diretórios preservados e processados

Em cenários de trabalho regulares:

Depois que o agente CDR no nó é executado e o serviço CallManager envia os arquivos para o Editor, eles são armazenados no preserve/yyyymmdd no Publisher. Se o CAR estiver ativado, serão criados links simbólicos para esses arquivos no car/yyyymmdd local. Se os servidores de cobrança estiverem configurados, links simbólicos para esses arquivos também serão criados no destinationX/yyyymmdd local, onde X pode ser 1,2 ou 3 (porque no máximo três servidores de cobrança podem ser configurados).

Os arquivos permanecem no preserve até que o CDR Loader processe esses arquivos e insira os registros correspondentes a esses arquivos no banco de dados CDR. Depois que os arquivos CDR são processados, eles são movidos para o processed local.

Se o CDR Loading estiver ativado e se os Billing Servers estiverem configurados, os arquivos CDR permanecerão no preserve local até que ambas as operações sejam concluídas, ou seja, até que a CDR Load e a transferência de arquivos para o servidor de cobrança sejam concluídas.

Assim, em cenários típicos, todos os arquivos simples do CDR estão no processed do local em vez de preserve local. Isso significa que todas as operações para esses arquivos foram concluídas.

Exemplo:

Se você solucionar problemas de dados CDR de uma determinada data (por exemplo, 17 de julho de 2018), poderá verificar se os arquivos associados existem na preserve diretório ou processed diretório.

Para verificar se o preserve diretório contém arquivos:

file list activelog /cm/cdr_repository/preserve/20180717

Para verificar se processed diretório contém arquivos:

file list activelog /cm/cdr_repository/processed/20180717

Interação de serviço

Para entender melhor a interação do serviço, suponha que haja dois servidores no cluster: Editor e Assinante. Suponha que o serviço CallManager seja executado somente no Assinante. Veja como os arquivos CDR e CMR são gerenciados:

• O serviço CallManager no Assinante gera arquivos simples CDR/CMR localmente.
  
  
• O serviço Agente CDR no Assinante transfere esses arquivos para o cdr_repository estrutura de diretórios no Publisher. Após a transferência ser concluída, a cópia local desses arquivos no Assinante será excluída.
  
  
• Se os servidores de faturamento estiverem configurados, o serviço CDR Repository Manager no Publisher transferirá esses arquivos simples para os servidores de faturamento.
  
  
• Se Continuous Loading 24/7 está ativado (na ferramenta Análise e Relatório CDR), então o serviço do CAR Scheduler no Publisher insere as informações de chamada nos arquivos simples no banco de dados CAR no Publisher.

Note: Para cada nó que executa o serviço CallManager, o serviço CDR Agent nesse nó é responsável por transferir os arquivos simples para o cdr_repository no Publisher. Se o serviço CallManager também for executado no Publisher, o serviço CDR Agent no Publisher transferirá os arquivos simples para o cdr_repository estrutura de diretórios no Publisher.

Configurar

1. Ative o CDR e navegue para System > Service Parameter > Call Manager Service. Defina o CDR Enabled Flag Verdadeiro. Isso deve ser feito para todos os nós no servidor.
   
   

   
   
   

2. Ative o CMR e navegue para System > Service Parameter > Call Manager Service.
   
   

   Defina o Call Diagnostics Enabled parâmetro para: Enabled Only When CDR Enabled Flag is True (gerar CMRs somente quando o parâmetro de serviço CDR Enabled Flag estiver definido como True) ou Enabled Regardless of CDR Enabled Flag (gera CMR sem ter em conta o valor da CDR Enabled Flag parâmetro de serviço).
   
   

   Este é um parâmetro de nível de cluster.
   
   

   
   
   

3. Cluster ID: Esse parâmetro fornece um identificador exclusivo para o cluster porque o parâmetro é usado em CDRs, coleções de CDRs de vários clusters que podem ser rastreados até as origens. O valor padrão especifica StandAloneCluster. O comprimento máximo é de 50 caracteres e fornece um ID de cluster válido que inclui qualquer um destes caracteres: A-Z, a-z, 0-9
   
   

   
   
   

   Note: A configuração do CDR é feita e essas etapas adicionais são necessárias para enviar arquivos CDR ao servidor SFTP.

   
   
   
4. Agora adicione o servidor SFTP/Servidor de cobrança para onde os arquivos devem ser enviados. Navegar para Cisco Unified Serviceability > Tools > CDR Management e adicione o novo servidor de cobrança.
   
   

   
   
   

5. Para criar uma programação para enviar registros CDR, navegue para Tools > CDR Analysis and Reporting e, em seguida, System > Scheduler > CDR Load.
   
   

   
   
   

   
   
   

   Disable Loader - Para desabilitar o carregamento de dados CDR, use esta opção se não quiser que os dados CDR sejam carregados no banco de dados CAR. As mudanças entram em vigor à meia-noite. Você também deve usar essa opção se uma operação de limpeza manual tiver que ser executada (o carregador deve ser desabilitado antes de executar a operação de limpeza). Pare e reinicie o serviço do CAR Scheduler para que a alteração entre em vigor imediatamente.

   Continuous Loading 24/7 - Permite que o CDR Loader seja executado continuamente 24 horas por dia, 7 dias por semana, para carregar CDRs no banco de dados CAR. Essa opção representa a configuração padrão do CDR Load Scheduler.

   Note: Se essa opção for escolhida, ela terá precedência sobre e ignorará os outros parâmetros de carga CDR e CMR na tela, como Time, Loading Interval, Duration,e Uninhibited Loading.

   Load CDR Only - Marque esta caixa para carregar somente registros CDR no banco de dados CAR. Com esta opção, os registros CMR não são carregados no banco de dados CAR. Essa opção representa a configuração padrão do CDR Load Scheduler. Você deve desmarcar manualmente o Load CDR only para forçar o carregamento dos registros CMR com os registros CDR.
   
   

6. Para obter o relatório manualmente, navegue para CDR > Export CDR,conforme mostrado na imagem:
   
   

   
   
   

   
   
   

   As datas podem ser selecionadas de acordo e você obtém a página, como mostrado na imagem.

   
   
   

   
   
   

   Clique no botão CDR Dump /CMR Dump para baixar o arquivo. Certifique-se também de desmarcar Delete File para que os arquivos não sejam permanentemente excluídos do CUCM.

   
   
   

Verificar

De Cisco Unified Serviceability, navegue para Tools > CDR Analysis and Reporting. A mensagem pop-up fornece uma visão geral da configuração do CDR, bem como uma visão geral de alto nível do número de registros no banco de dados do CDR.

Verificar as chamadas de CDR > Search (e use qualquer uma das opções para acompanhar a chamada).

Exemplo: Sob CDR Search by User Phone number, você pode digitar o número de telefone e obter os detalhes da chamada para isso, como mostrado na imagem.

Troubleshoot

De Cisco Unified Serviceability, navegue para Tools > CDR Analysis and Reporting. A mensagem pop-up fornece uma visão geral da configuração do CDR, bem como uma visão geral de alto nível do número de registros no banco de dados do CDR. A janela pop-up lista todos os erros principais relacionados à configuração.

Para qualquer erro, tente reiniciar esses serviços onde eles são executados no cluster:

• Agente CDR
• CDR Repository manager
• Agendador CAR
• Serviço Web CAR
• Serviço Soap-CDRonDemand

O serviço do banco de dados Cisco CAR (DB) também pode ser reiniciado via CLI do editor:

• utils service stop Cisco CAR DB
• utils service start Cisco CAR DB

Note: Não pressionar Ctrl+C para interromper as ações. Aguarde até que o serviço seja interrompido/iniciado corretamente.

Se o problema ainda estiver presente, colete esses registros para todos os nós :

• Agendador Cisco CAR
• Cisco CAR Web Service
• Cisco CDR Agent
• Cisco CDr Repository Manager
• Cisco Call Manager

Para obter mais detalhes, consulte Troubleshooting de CDR.