Esta aplicación es un trabajo para la materia Monitoreo y Gestión de Redes de la carrera de Ingeniería en Infomática de la Universidad de Mendoza. Bajo ningún concepto se debe utilizar esta aplicación en producción, ya que puede generar grandes problemas en un servidor al matar procesos, repriorizarlos o crear nuevos.
Esta aplicación esta hecha en Django (python) Se debe tener instalado Python 2.7.x
Para instalar las dependencias, simplemente correr:
pip install -r requirements.txt
python manage.py migratePara correr el servidor
python manage.py runserverEl sistema es una API RESTful que trabaja con formato JSON. Presenta funcionalidades para controlar los procesos corriendo en el sistema. El sistema está preparado para sistema UNIX. Es posible ampliar la funcionalidad a Windows sin mayores inconvenientes.
La misma ha sido desarrollada en Python, utilizando Django para armar la API y el administrador. Para manejar los procesos se utilizo la herramienta psutil.
El servidor está en http://monitoreo.donnanicolas.com.ar/
Ingresando al administrador (http://monitoreo.donnanicolas.com.ar/admin/) con su clave y contraseña y cree una key y luego se debe enviar en cada request en el header Authorization de la siguiente manera:
Authorization: Bearer [su clave]
La aplicación cuenta con 8 rutas
La misma devuelve todos los procesos corriendo en el sistema. Los campos devueltos son los siguientes:
Nombre | Explicación ------------ | ------------- | ------------- cmdline | Comando de la linea de comando con que fue llamado connections | Sockets abiertos por este procesos cpu_percent | Porcentaje de procesamiento ocupado cpu_times | Arreglo con [segundos en espacio de usuario, segundos en espacio de sistema] cpu_affinity | En que procesador/es correr este proceso create_time | Tiempo de creación cwd | Directorio absoluto de trabajo exe | El ejecutable de este proceso gids | Arreglo con los valores de los ids de grupo para real, effective and saved memory_info | Arreglo con RSS (Resident Set Size) y VMS (Virtual Memory Size) en bytes. Cambia según OS ver psutil memory_info_ex | Ver psutil#memory_info_ex memory_maps | Mapas de memoria memory_percent | Porcentaje de la memoria fisica utilizada, en relación al RSS name | Nombre del proceso nice | Prioridad num_ctx_switches | Numero de cambio de contexto num_fds | Número de file descriptors num_threads | Número de hilos open_files | Número de archivos abiertos, y su file descriptor. En windows el fd siempre es -1 pid | El id del proceso ppid | El id del proceso padre status | El estado del proceso como un string terminal | El terminal asociado con este proceso, si hay threads | Los threads the proceso uids | Arreglo con los valores de los ids de grupo para real, effective and saved username | El usuario dueño de este proceso
Dependiendo de la plataforma puede aparecer algunos campos más, para más información dirigirse a psutil#Process
:process debe ser un pid.
Devuelve la información del proceso :process. Para información sobre los campos ver GET /ps
Devuelve los usuarios que están corriendo procesos en el sistema.
| Nombre | Explicación |
|---|---|
| username | Nombre del usuario |
| running | Cantidad de procesos que está corriendo |
:username debe ser un usuario existente en el sistema Devuelve la información sobre los procesos que está corriendo el usuario con el nombre :username
Para más información sobre los campos vea GET /ps
Esta ruta corre el comando que se pasa como parametro cmd. Es una funcionalidad peligrosa ya que se puede correr virtualmente cualquier comando.
Los procesos solo se podrán correr de acuerdo a los permisos que tiene el usuario que está corriendo el servidor.
Los procesos tiene un tiempo máximo de ejecución de 10 segundos, después de los cuales el mismo es terminado si sigue corriendo.
| Nombre | Explicación |
|---|---|
| cmd | El comando a correr |
{
"cmd": "ls",
}Como no sabemos de antemano el tiempo que va a llevar el proceso y no podemos utilizar el stream debido a que no estamos usando streaming, el resultado es enviado a un archivo.
Los procesos tienen 10 segundo para terminar, al cabo de ese tiempo son destruidos.
El resultado de esta ruta es el pid del proceso, y output, un id de 32 letras que permite obtener el resultado del proceso. Ver GET /ps/output/:output.
Se puede utilizar pipes, retorna el pid de la primera parte del pipe
{
"cmd": "ls | grep Procfile | wc | awk '{print $3}'"
}La última parte del pipe tiene las misma condiciones que un proceso sin pipe, o sea 10 segundos para terminar.
Los errores de cualquier parte del comando son guardados en el output, pero solo el stdout de la ultima es guardado.
Si el valor de :output es el valor output devuelto por POST /ps, entonces se obtendra lo escrito en stdout y stderr por ese proceso.
| Nombre | Explicación |
|---|---|
| out | Lo escrito en stdout por el proceso |
| err | Lo escrito en stderr por el proceso |
Esta ruta envia un SIGKILL al proceso bajo con el pid enviado como argumento. Para evitar problemas si el pid es el mismo proceso o es padre del proceso del servidor no se puede matar.
| Nombre | Explicación |
|---|---|
| pid | Id del proceso |
{
"pid": "8802"
}Atención: No siempre será posible matar al proceso, esto generalmente ocurre por que el proceso pertenece a otro usuario.
Ver scripts
Atención: esto puede exponer su servidor. No se recomienda esta solución
Se puede configurar para que el proceso del servidor sea corrido por el usuario root
Atención: esto puede exponer su servidor. No se recomienda esta solución
Se puede modificar el archivo /etc/sudoers, agregando la linea:
<username> ALL= NOPASSWD:/usr/bin/kill
Donde username es el nombre del usuario que corre el servidor.
Esta ruta simplemente corre el comando renice.
| Nombre | Explicación |
|---|---|
| pid | Id del proceso |
| priority | Nueva prioridad. Valor en -20 y 20 |
{
"pid": "8802",
"priority": 10
}El comando renice requiere permisos especiales, por lo tanto solo podrá ser utilizado si el proceso del servidor tiene permisos para hacerlo.
Ver scripts
Atención: esto puede exponer su servidor. No se recomienda esta solución
Se puede configurar para que el proceso del servidor sea corrido por el usuario root
Atención: esto puede exponer su servidor. No se recomienda esta solución
Se puede modificar el archivo /etc/sudoers, agregando la linea:
<username> ALL= NOPASSWD:/usr/bin/renice,/bin/nice
Donde username es el nombre del usuario que corre el servidor.