Documentacion de administador VIVAit Alert 1.0 - Historial de revisiones

Gracia.moreno: /* MDalertas_WEB.conf */

2019-11-04T11:36:35Z

MDalertas_WEB.conf

Gracia.moreno: /* Log's */

2019-06-12T09:58:43Z

Log's

Gracia.moreno: /* Zabbix */

2019-06-12T09:55:15Z

Zabbix

Gracia.moreno: /* Zabbix */

2019-06-12T09:54:27Z

Zabbix

Gracia.moreno: /* Procedimiento almacenado */

2019-06-12T09:45:16Z

Procedimiento almacenado

Gracia.moreno: /* Procedimiento almacenado */

2019-06-12T09:45:02Z

Procedimiento almacenado

Gracia.moreno: /* Procedimiento almacenado */

2019-06-12T09:44:17Z

Procedimiento almacenado

Gracia.moreno: /* DAT_ESTADOS_SERVICIOS */

2019-06-12T09:43:16Z

DAT_ESTADOS_SERVICIOS

Gracia.moreno: /* Estructura de la Base de Datos */

2019-06-12T09:38:07Z

Estructura de la Base de Datos

Gracia.moreno: /* MDalertas_WEB.conf */

2019-06-12T07:20:59Z

MDalertas_WEB.conf

@@ Línea 387: / Línea 387: @@
 =yes
-Se ha creado una variable, alert_des_ultrecurso, en ex_Mdtel_particular que permite encaminar las llamadas al sistema de alertas hacía un destino definido, cuando todos los elementos del sistema fallan y no es posible finalizar las llamadas del modo habitual.
+Se ha creado una variable, alert_des_ultrecurso, en ex_Mdtel_particular.conf que permite encaminar las llamadas al sistema de alertas hacía un destino definido, cuando todos los elementos del sistema fallan y no es posible finalizar las llamadas del modo habitual.
 === Estructura de la Base de Datos ===

← Revisión anterior		Revisión del 09:58 12 jun 2019
Línea 631:		Línea 631:

	=== Log's ===		=== Log's ===
		+
		+	Los log’s están en:
		+	'''var/log/asterisk/full'''
		+
		+	Hay que filtrar las llamadas por el origen, destino, VDN de emergencia, …
		+
		+	A partir de este filtro se obtendrá el ucid, éste es único por lo que facilitará seguir el hilo de una llamada.
		+	También se pueden buscar los destinos, nos ayudará a encontrar las llamadas que buscamos.

@@ Línea 628: / Línea 628: @@
 Donde pone zabbix_sender hay que poner la IP y nombre del servidor de zabbix.
-Esto solo monitoriza el camino de la llamada entre dos maquinas internas, hay que hablar con VODAFONE para que nos proporcione DDIs para probar los primarios, los trunksips, etc...
+Esto solo monitoriza el camino de la llamada entre dos maquinas internas, hay que hablar con el operador para que nos proporcione DDIs para probar los primarios, los trunksips, etc...
 === Log's ===

← Revisión anterior		Revisión del 09:54 12 jun 2019
Línea 495:		Línea 495:

	=== Zabbix ===		=== Zabbix ===
		+
		+	Para monitorizar el sistema se utiliza Zabbix.
		+
		+	Se crea el fichero UserParameter con el contenido:
		+
		+	UserParameter=asterisk.mdalertas[],sudo /usr/sbin/asterisk -rx 'aler show' \| grep -o '$1\=[0-9]' \| cut -f 2 -d "="
		+
		+	Se crean los ítems como en la imagen adjunta, poniendo entre los corchetes la variable a monitorizar:
		+
		+	En el servidor zabbix de la maquina hay una gráfica para el nodo ParCar donde se pueden visualizar dichas variables.
		+
		+	[[File:Zabbix.png\|800px]]
		+
		+	La monitorización de app_mdalertas se hará ejecutando, desde agente zabbix, el siguiente comando cada 30 minutos, en explotación; y 5 minutos en pruebas:
		+
		+	root@ParCar:/usr/src/MDtel/asterisk# asterisk -rx 'aler show'
		+	aler debug=0 errores=0 caducados=0 alertas_en_curso=0 aler_mem=0
		+
		+	La interpretación de la respuesta es:
		+
		+	*Si la respuesta no comienza con "aler", es que el módulo no está correctamente cargado.
		+	*El valor de "debug" [0\|1] indica si está activa la depuración. Puede ignorarse.
		+	*El valor de "errores" es un contador de éstos. Debe ser cero o debe analizarse el log de Asterisk para buscar la fuente del problema que seguro existe.
		+	*El valor de "caducados". también es un contador, indica situaciones de emergencia con antigüedad superior a una hora. Lo más probable es que se trate de algún tipo de fuga de memoria, por lo que debemos buscar la llamada y analizarla para depurar un problema.
		+	*El valor de "alertas_en_curso" es un contador que indica cuántas alertas hay en curso. Puede ignorarse, excepto por el caso de que sea cero y el contador siguiente ("aler_mem" ) tenga un valor superior a cero. Si es así, hay un problema que debe diagnosticarse.
		+	*El valor "aler_mem" puede ignorarse, excepto en lo indicado en el punto anterior.
		+
		+	Una vez conocido el problema, pueden reiniciarse los contadores con el comando Asterisk:
		+
		+	"module reload app_mdalertas.so"
		+
		+	¡Cuidado! este comando ('''de muy rápida ejecución''') sólo debe ejecutarse sin alertas en curso.
		+
		+	Se crea el fichero /etc/zabbix/zabbix_agentd.conf.d/UserParameter_MDalertas.conf con el contenido:
		+
		+	UserParameter=asterisk.mdalertas[],sudo /usr/sbin/asterisk -rx 'aler show' \| grep -o '$1\=[0-9]' \| cut -f 2 -d "="
		+
		+	Se modifica el template Vivait-Call Asterisk.xml donde se crean los items.
		+
		+	Para generar llamadas automáticas para monitorizar el servicio de alertas crearemos el script /usr/local/sbin/generarLlamada_Alertas.sh y su correspiondiente cron.d generarLlamada_Alerta
		+
		+
		+	#!/bin/sh
		+
		+	asterisk -rx "originate local/9899@Cen_InicioLlamada_Emer_Test_ENTRAFUE extension 899@Cen_InicioLlamada_Emer_Test_ENTRADEN"
		+	SHELL=/bin/sh
		+	PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
		+
		+	# m h dom mon dow user command
		+	30 0 * * * root generarLlamada_Alertas.sh
		+
		+	Donde el 9899 será un VDN corporativo en la maquina donde esté el módulo de alertas y los contextos Cen_InicioLlamada_Emer_Test_ENTRAFUE y
		+	Cen_InicioLlamada_Emer_Test_ENTRADEN estarán creados en el fichero ext_InicioLlamada_Emer_Particular.conf
		+
		+	'''[Cen_VDN_9899]'''
		+
		+	;----------------------------------------------------------------------------------------------------------------
		+	;----------------------- VDN 9899 ----------------------------------
		+	;----------------------------------------------------------------------------------------------------------------
		+	exten => _X.,1,NoOp(MDVDN_9899***EXTEN=${EXTEN}CID=${CALLERID(NUM)}*UCID=${UCID})
		+
		+	same => n,Answer
		+
		+	same => n,Goto(Cen_VDN_Alertas,9999,1)
		+
		+	same => n,HangUp(16)
		+
		+	include => Cen_finLlamada
		+
		+
		+	Esto llamará al vdn de alertas 9999, que estará creado por defecto en el fichero MDalertas.conf de la siguiente forma:
		+
		+
		+	[9999_vdn]
		+	vdn=9999
		+	id_entidad=0
		+	id_servicio=0
		+	tipo_servicio=10
		+	sin_segmentos=yes
		+	grabacion_msj_prefijo=/var/spool/MDtel/Alertas/Pruebas/
		+	locucion_comunicacion=/var/lib/asterisk/sounds/Alertas/ALE_emer_notif
		+	locucion_confirmacion=/var/lib/asterisk/sounds/Alertas/ALE_emer_confir
		+	locucion_informacion=/var/lib/asterisk/sounds/Alertas/ALE_emer_dejar
		+	locucion_secundario=/var/lib/asterisk/sounds/WEB/Alertas/locicion_secundario
		+	cad_copia_wav1=-
		+	cad_copia_wav2=-
		+	tiempo_descolgado=5
		+	tiempo_confirmacion=10
		+	tiempo_grabacion=60
		+	eje1=01
		+	autorizada=no
		+
		+	[9999_dest_0000]
		+	secundario=no
		+	destino=9898
		+	origen_nombre=pruebas_1
		+	origen_num=1000
		+	confirmar=yes
		+	funcion=0
		+	id_destino=0
		+
		+
		+	El destino 9898 será un VDN corporativo y estará en la maquina donde se ejecute el script de la llamada automática generarLlamada_Alertas.sh
		+
		+
		+	[Cen_VDN_9898]
		+
		+	;----------------------------------------------------------------------------------------------------------------
		+	;----------------------- VDN 90000 ----------------------------------
		+	;----------------------------------------------------------------------------------------------------------------
		+	exten => _X.,1,NoOp(MDVDN_9898***EXTEN=${EXTEN}CID=${CALLERID(NUM)}*UCID=${UCID})
		+
		+	same => n,Answer
		+	same => n,AMD(670,1500,800,5000,100,50,20,256,5000)
		+	;same => n,AMD()
		+	same => n,NoOp(MDMCAMDSTAMDSTATUS=${AMDSTATUS}AMDCAUSA=${AMDCAUSE}*)
		+	same => n,Goto(${AMDSTATUS})
		+	same => n(NOTSURE),Goto(fin)
		+	same => n(HUMAN),System(/usr/local/bin/zabbix_sender -z 127.0.0.1 -s Homologacion-Corp1 -k "mdalertatest" -o 1)
		+	same => n,MDintz(nimitz\|bd\|sqlSinEspera\|call ACD_PROC_ESTADO_SERVICIO(9,10,0,10,0))
		+	same => n,Goto(fin)
		+	same => n(MACHINE),System(/usr/local/bin/zabbix_sender -z 127.0.0.1 -s Homologacion-Corp1 -k "mdalertatest" -o 0)
		+	same => n,MDintz(nimitz\|bd\|sqlSinEspera\|call ACD_PROC_ESTADO_SERVICIO(9,10,0,100,0))
		+	same => n,Goto(fin)
		+	same => n(HANGUP),Goto(fin)
		+
		+	same => n(fin),Hangup()
		+
		+	include => Cen_finLlamada
		+
		+
		+	Donde pone zabbix_sender hay que poner la IP y nombre del servidor de zabbix.
		+
		+	Esto solo monitoriza el camino de la llamada entre dos maquinas internas, hay que hablar con VODAFONE para que nos proporcione DDIs para probar los primarios, los trunksips, etc...

	=== Log's ===		=== Log's ===

@@ Línea 487: / Línea 487: @@
 ID_APLICACION
 E_TIPO_SERVICIO
 E_ESTADO_SERVICIO
 N_VALOR

@@ Línea 479: / Línea 479: @@
 === Procedimiento almacenado ===
 === Zabbix ===
 === Log's ===

← Revisión anterior		Revisión del 09:43 12 jun 2019
Línea 405:		Línea 405:

	=== DAT_ESTADOS_SERVICIOS ===		=== DAT_ESTADOS_SERVICIOS ===
		+
		+	Se ha preparado una tabla para monitorizar el estado de los servicios del sistema de alertas:
		+
		+	'''DAT_ESTADOS_SERVICIOS'''
		+
		+	CREATE TABLE IF NOT EXISTS `nimitz`.`DAT_ESTADOS_SERVICIOS` (
		+	`ID_APLICACION` INT NOT NULL,
		+	`E_TIPO_SERVICIO` INT NOT NULL COMMENT 'TTipoServicio',
		+	`N_INSTANCIA` INT NOT NULL,
		+	`E_ESTADO_SERVICIO` INT NULL DEFAULT 0 COMMENT 'TEstadoServicio',
		+	`N_VALOR` INT NULL,
		+	`D_FECHA_ACTUALIZACION` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
		+	PRIMARY KEY (`ID_APLICACION`, `E_TIPO_SERVICIO`, `N_INSTANCIA`))
		+	ENGINE = InnoDB
		+
		+	Esta tabla tendrá un registro por cada servicio a monitorizar.
		+
		+	Los campos de la tabla son los siguientes:
		+
		+	'''ID_APLICACION'''
		+
		+	El id que corresponda de la tabla COM_APLICACIONES, aunque es una tabla existe un enumerado que es un reflejo de la tabla (TAplicacion).
		+
		+	//Sincronizada con la tabla COM_APLICACIONES
		+	//Id: 400-499
		+	TAplicacion = (
		+	aplicacion_Comun=1,
		+	aplicacion_Centralita=2,
		+	aplicacion_ACD=3,
		+	aplicacion_Mensajeria=4,
		+	aplicacion_Grabacion=5,
		+	aplicacion_SMS=6,
		+	aplicacion_Fax=7,
		+	aplicacion_Meet=8,
		+	aplicacion_Alertas=9
		+	);
		+
		+	'''E_TIPO_SERVICIO'''
		+
		+	El tipo de servicio, los valores se corresponden con el enumerado (TTipoServicio):
		+
		+	// Tipo de servicios (tabla DAT_ESTADOS_SERVICIOS)
		+	// Id: 9300-9399
		+	//
		+	TTipoServicio=(
		+	tipoServicio_alertas = 10
		+	); //9300
		+
		+	'''N_INSTANCIA'''
		+
		+	Por si hubiera mas de una instancia del servicio, por defecto 0.
		+
		+	'''E_ESTADO_SERVICIO'''
		+
		+	Estado del servicio, los valores se corresponden con el enumerado (TEstadoServicio):
		+
		+	// Estado del servicio (tabla DAT_ESTADOS_SERVICIOS)
		+	// Id: 9400-9399
		+	//
		+	TEstadoServicio=(
		+	estadoServicio_desconocido = 0,
		+	estadoServicio_ok = 10,
		+	estadoServicio_alarma = 100
		+	); //9400
		+
		+	'''N_VALOR'''
		+
		+	Un valor numérico por si queremos reflejar algún valor.
		+
		+	'''D_FECHA_ACTUALIZACION'''
		+
		+	Esta fecha se actualiza automáticamente si se inserta o se modifica el registro de la tabla.

	=== Procedimiento almacenado ===		=== Procedimiento almacenado ===

← Revisión anterior		Revisión del 09:38 12 jun 2019
Línea 390:		Línea 390:

	=== Estructura de la Base de Datos ===		=== Estructura de la Base de Datos ===
		+
		+	El sistema de Alertas tiene las siguientes tablas:
		+
		+	[[File:Tablas BASE DE DATOS.jpg\|800px]]
		+
		+
		+	Excepto la tabla ALE_SEGMENTOS, todas se configuran a travé del portal web.
		+
		+	La estructura de la Base de Datos es la siguiente:
		+
		+	[[File:Esquema de ALERTAS.jpg\|800px]]

	== MONITORIZACIÓN DEL SISTEMA ==		== MONITORIZACIÓN DEL SISTEMA ==

← Revisión anterior		Revisión del 07:20 12 jun 2019
Línea 239:		Línea 239:

	==== MDalertas_WEB.conf ====		==== MDalertas_WEB.conf ====
		+
		+	Este fichero tiene una parte global en la que se configuran los siguientes parámetros:
		+
		+	{\| class="wikitable"
		+	\|-
		+	!Campo !! Descripción
		+	\|-
		+	\|[9000_vdn] \|\|
		+	\|-
		+	\|vdn=9000 \|\|
		+	\|-
		+	\|id_entidad=1 \|\|
		+	\|-
		+	\|id_servicio=1 \|\|
		+	\|-
		+	\|Id_dispositivo_llam_sal \|\| Identifica el dispositivo de llamada desde el que se realiza el conjunto de llamadas.
		+	\|-
		+	\|tipo_servicio=10 \|\| Define como se comporta el sistema desde un punto de vista operativo. Si el valor es 10 el servicio es del tipo Emergencia, si el valor es 20 el servicio es una Sala de Conferencia.
		+	\|-
		+	\|sin_segmentos=no \|\| Indica si se generan o no segmentos:
		+
		+	'''Yes''' → no se generan segmentos, por ejemplo, para llamadas de prueba.
		+
		+	'''No''' → se generan segmentos
		+	\|-
		+	\|locucion_comunicacion=/var/lib/asterisk/sounds/Alertas/ALE_emer_notif \|\| Locución que se reproduce cuando un usuario llama al servicio de emergencias.
		+	\|-
		+	\|locucion_confirmacion=/var/lib/asterisk/sounds/Alertas/ALE_emer_confir \|\| Locución que se reproduce en los teléfonos que reciben las llamadas de emergencias cuando alguien ha dejado un mensaje y se activa el sistema, antes de confirmar la llamada.
		+	\|-
		+	\|locucion_informacion=/var/lib/asterisk/sounds/Alertas/ALE_emer_dejar \|\| Locución que recibe la persona que llama al sistema de alertas
		+	\|-
		+	\|locucion_secundario=/var/lib/asterisk/sounds/WEB/Alertas/locicion_secundario \|\| Locución que recibe un destino secundario
		+	\|-
		+	\|tiempo_descolgado=20 \|\| Tiempo durante el que suena la llamada esperando que el usuario descuelgue el teléfono.
		+	\|-
		+	\|tiempo_confirmacion=60 \|\| Tiempo desde que el usuario descuelga hasta que está disponible la posibilidad de confirmación.
		+	\|-
		+	\|tiempo_grabacion=60
		+	\|-
		+	\|eje1=01 \|\| Sirve para grabar en los segmentos (graba la cadena)
		+	\|-
		+	\|autorizada=no \|\| Este campo controla la posibilidad de autorizar solo a algunos orígenes para que hagan llamadas al sistema de ALERTAS
		+	\|-
		+	\|dest_no_autorizada=0xxxxxxxxx \|\| Teléfono al que se enviarán las llamadas al sistema de ALERTAS cuando el número que llama al sistema no está autorizado.
		+	\|}
		+
		+	Además, el fichero tiene una parte para configurar los destinos primarios y secundarios:
		+
		+	{\| class="wikitable"
		+	\|-
		+	!Campo !! Descripción
		+	\|-
		+	\|'''[9000_dest_0000]''' \|\|
		+	\|-
		+	\|secundario=no \|\| Indica si el destino es primario o secundario:
		+
		+	'''NO''' → Primario
		+
		+	'''YES''' → Secundario
		+	\|-
		+	\|destino=4900 \|\|
		+	\|-
		+	\|origen_nombre=orig_5 \|\|
		+	\|-
		+	\|origen_num=1005 \|\| Sirve para identificar el número de EMERGENCIAS, si no lo identificamos el sistema utilizará el nº de teléfono que origina la EMERGENCIA.
		+	\|-
		+	\|confirmar=yes \|\| Indica si el destino puede confirmar la EMERGENCIA:
		+
		+	'''YES''' → Si puede confirmar
		+
		+	'''NO''' → No puede confirmar
		+	\|-
		+	\|funcion=1005 \|\| Hace referencia a la tabla de funciones.
		+	\|-
		+	\|id_destino=15 \|\| ID del usuario que va recibir la llamada de EMERGENCIA.
		+	\|-
		+	\|'''[9000_dest_0001]'''
		+	\|-
		+	\|secundario=yes \|\| Indica si el destino es primario o secundario:
		+
		+	'''NO''' → Primario
		+
		+	'''YES''' → Secundario
		+	\|-
		+	\|destino=4900 \|\|
		+	\|-
		+	\|origen_nombre=orig_6 \|\|
		+	\|-
		+	\|origen_num=1006 \|\| Sirve para identificar el número de EMERGENCIAS, si no lo identificamos el sistema utilizará el nº de teléfono que origina la EMERGENCIA.
		+	\|-
		+	\|confirmar=no \|\| Indica si el destino puede confirmar la EMERGENCIA:
		+
		+	'''YES''' → Si puede confirmar
		+
		+	'''NO''' → No puede confirmar
		+	\|-
		+	\|funcion=1006 \|\| Hace referencia a la tabla de funciones.
		+	\|-
		+	\|id_destino=16 \|\| ID del usuario que va recibir la llamada de EMERGENCIA.
		+	\|}
		+
		+
		+	A continuación, podemos ver las líneas de un fichero MDalertas_WEB.conf que corresponde con la configuración de una Sala de Conferencia (servicio tipo 20). Además, la Sala tiene configurados orígenes autorizados y códigos de confirmación para el usuario que llama al sistema.
		+
		+	[9007_vdn]
		+	vdn=9007
		+	id_entidad=48
		+	id_servicio=28
		+	id_dispositivo_llam_sal=1
		+	tipo_servicio=20
		+	sin_segmentos=no
		+	locucion_comunicacion=/var/lib/asterisk/sounds/WEB/Alertas/locucion_comunicacion_Salas
		+	locucion_confirmacion=/var/lib/asterisk/sounds/WEB/Alertas/locucion_comunicacion
		+	locucion_informacion=/var/lib/asterisk/sounds/WEB/Alertas/locucion_Sala_informacion
		+	locucion_secundario=/var/lib/asterisk/sounds/WEB/Alertas/locucion_comunicacion
		+	tiempo_descolgado=
		+	tiempo_confirmacion=
		+	tiempo_grabacion=
		+	eje1=01020202
		+	autorizada=yes
		+	dest_no_autorizada=06133
		+	codigo_confir_entra=321
		+	codigo_confir_sale=
		+
		+	[9007_dest_0000]
		+	secundario=no
		+	destino=06133
		+	origen_nombre=
		+	origen_num=
		+	confirmar=no
		+	funcion=
		+	id_destino=38
		+
		+	[9007_dest_0001]
		+	secundario=no
		+	destino=4002
		+	origen_nombre=
		+	origen_num=
		+	confirmar=no
		+	funcion=10
		+	id_destino=40
		+
		+
		+	[9007_autorizados]
		+	4002=yes
		+	06140=yes
		+	6133=yes
		+
		+	Se ha creado una variable, alert_des_ultrecurso, en ex_Mdtel_particular que permite encaminar las llamadas al sistema de alertas hacía un destino definido, cuando todos los elementos del sistema fallan y no es posible finalizar las llamadas del modo habitual.

	=== Estructura de la Base de Datos ===		=== Estructura de la Base de Datos ===