Configuración de CDR en la versión 11.5 de CUCM

Introducción

Este documento describe cómo configurar Call Detail Routing (CDR) en Cisco Unified Communications Manager (CUCM) versión 11.5.

Prerequisites

Requirements

Cisco le recomienda que tenga conocimiento acerca de este tema:

• Cisco Unified Communications Manager (CUCM) versión 11.5

Componentes Utilizados

La información de este documento se basa en la versión 11.5 de 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. Si tiene una red en vivo, asegúrese de entender el posible impacto de cualquier comando.

Antecedentes 

CUCM produce dos tipos de registros, que almacenan el historial de llamadas y la información de diagnóstico:

• Registros de detalles de llamadas (CDR): los registros de datos contienen información sobre cada llamada procesada por CallManager.
• Registros de gestión de llamadas (CMR): los registros de datos contienen información de calidad de servicio (QoS) o de diagnóstico sobre la llamada, también denominados registros de diagnóstico.

Tanto los CDR como los CMR juntos se denominan datos CDR. Los datos de CDR proporcionan un registro de todas las llamadas que han realizado o recibido los usuarios del sistema CallManager. Los datos de CDR son útiles principalmente para generar los registros de facturación; sin embargo, también se puede utilizar para realizar un seguimiento de la actividad de las llamadas, diagnosticar determinados tipos de problemas y planificar la capacidad.

Los CDR contienen información sobre el origen de la llamada, el destino de la llamada, la fecha y hora en que se inició la llamada, la hora en que se conectó realmente y la hora en que terminó. Una llamada se considera iniciada o originada cuando la persona que llama descuelga. La llamada se considera finalizada cuando la persona que llama o la persona a la que llama pasan al teléfono. Los CMR contienen información sobre la cantidad de datos enviados y recibidos, la fluctuación, la latencia y los paquetes perdidos.

Arquitectura

Servicios necesarios

CallManager

• El CallManager se puede activar en cualquier nodo del clúster.
  
  
• Procesa las llamadas y escribe datos CDR y CMR en archivos planos.
  
  
• Los archivos planos se generan a una frecuencia determinada por el CDR File Time Interval indicador debajo Enterprise Parameters.

Agente CDR

• El agente CDR se ejecuta como servicio de red en cada nodo de un clúster (esto incluye el editor).
  
  
• Sondea el directorio local para los archivos planos CDR y CMR cada seis segundos.
  
  
• Si encuentra nuevos archivos planos CDR y CMR, envía los archivos planos CDR y CMR desde ese nodo al nodo Repositorio CDR (Publisher).
  
  
• Una vez transferida correctamente, el sistema elimina la copia local del archivo.

Administrador de repositorios CDR

• El CDR Repository Manager se ejecuta como un servicio de red en todos los nodos de un clúster. Sin embargo, sólo el Administrador de repositorios CDR del Editor realiza ninguna acción. En todos los demás nodos, el servicio simplemente se inicia, pero luego se suspende.
  
  
• Crea la estructura de directorios utilizada por los servicios CAR.
  
  
• Administra los archivos planos recibidos de otros nodos. Cuando el archivo llega al nodo Repositorio de CDR, el Administrador de Repositorios de CDR lo detecta. El sistema archiva el archivo en un directorio dedicado a la fecha indicada por la marca de tiempo que se colocó en el nombre del archivo cuando se creó el archivo.
  
  
• Envía archivos CDR a hasta tres servidores de facturación externos.
  
  
• Mantiene archivos CDR durante un determinado número de días, hasta 30 días.
  
  
• Comprueba periódicamente el uso del disco y elimina los archivos antiguos. Los umbrales se configuran a través de la administración de CDR (que se trata más adelante en la presentación).
  
  
• Genera una alarma si la entrega falló o si el uso del disco es demasiado alto.

Planificador CAR

• El Planificador CAR se ejecuta como servicio de red en todos los nodos de un clúster. Sin embargo, sólo el servicio CAR Scheduler del editor realiza ninguna acción. En todos los demás nodos, el servicio simplemente se inicia, pero luego se suspende.
  
  
• Según la programación de carga de CDR, accede a los archivos CDR/CMR en la estructura de directorios que crea el servicio CDR Repository Manager, procesa estos archivos e inserta la información CDR en la base de datos CAR.
  
  
• El tamaño máximo de la base de datos CAR es de 6 Gb (no configurable). El Planificador CAR purga los datos de la base de datos CAR si excede los 6 Gb o si el número de registros supera los 2 millones. El límite de dos millones de registros incluye datos en ambos tbl_billing_data y tbl_billing_error.

Servicio web CAR

• El servicio web CAR solo se puede activar en el editor.
  
  
• Se ejecuta como servicio de funciones (Control Center Feature Services).
  
  
• Debe estar activo para acceder a la herramienta CDR Analysis and Reporting (CAR).

Servicio CDRonDemand

• El servicio CDRonDemand es un servicio basado en el protocolo simple de acceso a objetos (SOAP)/HTTPS que se ejecuta en el nodo de repositorio CDR (es decir, Publisher).
  
  
• Recibe solicitudes SOAP para listas de nombres de archivo CDR de un servidor de terceros basándose en un intervalo de tiempo especificado por el usuario (hasta un máximo de una hora) y devuelve todas las listas que coinciden con la duración especificada por la solicitud.

El servicio CDR a petición también puede manejar solicitudes para entregar un archivo CDR específico a un destino especificado a través de (s)FTP. El sistema puede activar el servicio CDR a petición en el nodo Repositorio CDR, ya que tiene que acceder a los archivos CDR en el repositorio.

Hay dos parámetros pertinentes en System > Enterprise Parameters que se utilizan para limitar las solicitudes del servidor de terceros:

• Consultas permitidas de CDRonDemandget_file por minuto (mín.:1, máx.:20, valor predeterminado:10)
• Consultas permitidas de CDRonDemandget_file_list por minuto (Min:1, Max:40, Default:20)

Estructura del Directorio del Administrador de Repositorios de CDR

La estructura del directorio del administrador de repositorio de CDR como se describe aquí sólo existe en el editor.

Todo bajo /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 - Los archivos se reciben del nodo CM.

tmp - Los archivos están a la espera de ser procesados.

preserve/yyyymmdd - Archivos que se enviarán o que se cargarán en CAR

processed/yyyymmdd - Archivos enviados correctamente a todos los destinos y cargados por CAR (si CAR no está activado y no hay ningún servidor de facturación configurado, los archivos se colocan aquí directamente).

destinationX/yyyymmdd - Contiene vínculos simbólicos a los archivos bajo conservación. El servicio CDR Repository Manager utiliza estos enlaces programables para determinar qué archivos deben transferirse al servidor de facturación.

car/yyyymmdd - Contiene vínculos simbólicos a los archivos bajo conservación. El servicio CAR Scheduler utiliza estos enlaces programables para determinar los archivos que necesita procesar el CDR Loader.

Comprender la conservación y los directorios procesados

En escenarios de trabajo normales:

Después de que el agente CDR en el nodo se ejecute y el servicio CallManager envíe los archivos al editor, se almacenan en el preserve/yyyymmdd en el Editor. Si se activa CAR, se crean vínculos simbólicos a estos archivos en el car/yyyymmdd ubicación. Si se configuran servidores de facturación, también se crean enlaces simbólicos a estos archivos en el destinationX/yyyymmdd ubicación, donde X puede ser 1, 2 o 3 (porque, como máximo, se pueden configurar tres servidores de facturación).

Los archivos permanecen en el preserve hasta que el Cargador CDR procese estos archivos e introduzca los registros que corresponden a esos archivos en la base de datos CDR. Una vez procesados los archivos CDR, se mueven al processed ubicación.

Si la carga de CDR está activada y si los servidores de facturación están configurados, los archivos CDR permanecerán en el preserve hasta que ambas operaciones se completen, es decir, hasta que se complete la carga de CDR y la transferencia de archivos al servidor de facturación.

Por lo tanto, en escenarios típicos, todos los archivos planos CDR se encuentran en el processed ubicación frente a preserve ubicación. Esto significa que se han completado todas las operaciones de esos archivos.

Ejemplo:

Si soluciona cualquier problema con los datos de CDR para una fecha determinada (por ejemplo, 17 de julio de 2018), puede comprobar si los archivos asociados existen en el preserve o processed directorio.

Para comprobar si el preserve El directorio contiene archivos:

file list activelog /cm/cdr_repository/preserve/20180717

Para comprobar si processed El directorio contiene archivos :

file list activelog /cm/cdr_repository/processed/20180717

Interacción de servicios

Para comprender mejor la interacción del servicio, asuma que hay dos servidores en el clúster: Publisher y Subscriber. Suponga que el servicio CallManager se ejecuta solamente en el Suscriptor. A continuación se explica cómo se administran los archivos CDR y CMR:

• El servicio CallManager en el Suscriptor genera archivos planos CDR/CMR localmente.
  
  
• El servicio Agente CDR en el Suscriptor transfiere estos archivos al cdr_repository en el Editor. Una vez finalizada la transferencia, se elimina la copia local de estos archivos en el Suscriptor.
  
  
• Si se configuran los servidores de facturación, el servicio CDR Repository Manager en el editor transfiere estos archivos planos a los servidores de facturación.
  
  
• Si Continuous Loading 24/7 está activado (en la herramienta Análisis e informes CDR) y, a continuación, el servicio CAR Scheduler del editor inserta la información de llamada en los archivos planos en la base de datos CAR del editor.

Nota: Para cada nodo que ejecute el servicio CallManager, el servicio CDR Agent en ese nodo es responsable de transferir los archivos planos al cdr_repository en el Editor. Si el servicio CallManager también se ejecuta en el editor, el servicio Agente CDR del editor transfiere los archivos planos al cdr_repository en el Editor.

Configurar

1. Habilitar CDR y navegar hasta System > Service Parameter > Call Manager Service. Establecer el CDR Enabled Flag a True. Esto debe hacerse para todos los nodos del servidor.
   
   

   
   
   

2. Habilite CMR y navegue hasta System > Service Parameter > Call Manager Service.
   
   

   Establecer el Call Diagnostics Enabled parámetro para: Enabled Only When CDR Enabled Flag is True (genere CMR sólo cuando el parámetro de servicio CDR Enabled Flag esté establecido en True) o Enabled Regardless of CDR Enabled Flag (genera CMR independientemente del valor del CDR Enabled Flag parámetro de servicio).
   
   

   Este es un parámetro de todo el clúster.
   
   

   
   
   

3. Cluster ID: Este parámetro proporciona un identificador único para el clúster porque el parámetro se utiliza en los CDR, colecciones de CDR de varios clústeres que se pueden rastrear hasta los orígenes. El valor predeterminado especifica StandAloneCluster. La longitud máxima es de 50 caracteres y proporciona un ID de clúster válido que incluye cualquiera de estos caracteres: A-Z, a-z, 0-9
   
   

   
   
   

   Nota: La configuración de CDR se realiza y estos pasos adicionales son necesarios para enviar archivos CDR al servidor SFTP.

   
   
   
4. Ahora agregue el servidor SFTP/servidor de facturación donde se enviarán los archivos. Vaya a Cisco Unified Serviceability > Tools > CDR Management y agregue el nuevo servidor de facturación.
   
   

   
   
   

5. Para crear una programación para enviar registros CDR, navegue hasta Tools > CDR Analysis and Reporting y, a continuación, System > Scheduler > CDR Load.
   
   

   
   
   

   
   
   

   Disable Loader - Para inhabilitar la carga de datos CDR, utilice esta opción si no desea que los datos CDR se carguen en la base de datos CAR. Los cambios surten efecto a medianoche. También debe utilizar esta opción si se debe realizar una operación de depuración manual (el cargador debe estar desactivado antes de ejecutar la operación de depuración). Detenga y reinicie el servicio CAR Scheduler para que el cambio surta efecto inmediatamente.

   Continuous Loading 24/7 - Habilita el cargador CDR para funcionar continuamente 24 horas al día, 7 días a la semana para cargar los CDR en la base de datos CAR. Esta opción representa la configuración predeterminada para el Planificador de carga CDR.

   Nota: Si se elige esta opción, tendrá prioridad sobre e ignorará los demás parámetros de carga de CDR y CMR en la pantalla, como Time, Loading Interval, Duration,y Uninhibited Loading.

   Load CDR Only - Marque esta casilla para cargar solamente registros CDR en la base de datos CAR. Con esta opción, los registros CMR no se cargan en la base de datos CAR. Esta opción representa la configuración predeterminada para el Planificador de carga CDR. Debe desmarcar manualmente Load CDR only para forzar que los registros CMR se carguen con los registros CDR.
   
   

6. Para obtener el informe manualmente, navegue hasta CDR > Export CDR, como se muestra en la imagen:
   
   

   
   
   

   
   
   

   Las fechas se pueden seleccionar en consecuencia y se obtiene la página, como se muestra en la imagen.

   
   
   

   
   
   

   Haga clic en el CDR Dump /CMR Dump para descargar el archivo. Asegúrese también de desmarcar Delete File para que los archivos no se eliminen permanentemente de CUCM.

   
   
   

Verificación

Desde Cisco Unified Serviceability, desplácese hasta Tools > CDR Analysis and Reporting. El mensaje emergente proporciona una descripción general de la configuración de CDR, así como una descripción general de alto nivel del número de registros en la base de datos de CDR.

Verificar las llamadas desde CDR > Search (y utilice cualquiera de las opciones para realizar un seguimiento de la llamada).

Ejemplo: En CDR Search by User Phone number, puede introducir el número de teléfono y obtener los detalles de la llamada, como se muestra en la imagen.

Troubleshoot

Desde Cisco Unified Serviceability, desplácese hasta Tools > CDR Analysis and Reporting. El mensaje emergente proporciona una descripción general de la configuración de CDR, así como una descripción general de alto nivel del número de registros en la base de datos de CDR. La ventana emergente muestra los errores principales relacionados con la configuración.

Para cualquier error, intente reiniciar estos servicios donde se ejecutan en el clúster:

• Agente CDR
• Administrador del repositorio CDR
• Planificador CAR
• Servicio web CAR
• Servicio Soap-CDRonDemand

El servicio de base de datos Cisco CAR (DB) también se puede reiniciar mediante Publisher CLI :

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

Nota: No pulse Ctrl+C para interrumpir las acciones. Espere hasta que el servicio se haya detenido/iniciado correctamente.

Si el problema sigue presente, recopile estos registros para todos los nodos :

• Planificador CAR de Cisco
• Servicio web Cisco CAR
• Agente CDR de Cisco
• Administrador de repositorios de CDr de Cisco
• Call Manager de Cisco

Para obtener más detalles, consulte Solución de problemas de CDR.