[comment]: # attributes: notoc

[comment]: # ({22d75789-22d75789})
# 1 Agente Zabbix

[comment]: # ({/22d75789-22d75789})

[comment]: # ({aae5ae72-d63c67a4})
### Visión general

Esta sección proporciona detalles sobre las claves de item que utilizan la comunicación con el agent de Zabbix para la recopilación de datos.

Existen comprobaciones de agent [pasivas y activas](/manual/appendix/items/activepassive).
Al configurar un item, puede seleccionar el tipo requerido:

-   *Zabbix agent* - para comprobaciones pasivas
-   *Zabbix agent (active)* - para comprobaciones activas

Tenga en cuenta que todas las claves de item admitidas por el agent de Zabbix también son compatibles con el agent de Zabbix de nueva generación, agent 2.
Consulte las [claves de item adicionales](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) que puede utilizar solo con el agent 2.

[comment]: # ({/aae5ae72-d63c67a4})

[comment]: # ({3fd8c340-cefe2e1b})
### Claves de item soportadas

Las claves de item que puede utilizar con el agent de Zabbix se enumeran a continuación.

Las claves de item se enumeran sin parámetros ni información adicional.
Haga clic en la clave de item para ver todos los detalles.

|Clave de item|Descripción|Grupo de item|
|--|-------|-|
|[kernel.maxfiles](#kernel.maxfiles)|El número máximo de archivos abiertos soportados por el SO.|Kernel|
|[kernel.maxproc](#kernel.maxproc)|El número máximo de procesos soportados por el SO.|^|
|[kernel.openfiles](#kernel.openfiles)|El número de descriptores de archivos abiertos actualmente.|^|
|[log](#log)|La monitorización de un archivo de registro.|[Monitorización de registros](log_items)|
|[log.count](#log.count)|El recuento de líneas coincidentes en un archivo de registro monitorizado.|^|
|[logrt](#logrt)|La monitorización de un archivo de registro que se rota.|^|
|[logrt.count](#logrt.count)|El recuento de líneas coincidentes en un archivo de registro monitorizado que se rota.|^|
|[modbus.get](#modbus)|Lee datos Modbus.|Modbus|
|[net.dns](#net.dns)|Comprueba el estado de un servicio DNS.|Red|
|[net.dns.perf](#net.dns.perf)|Comprueba el rendimiento de un servicio DNS.|^|
|[net.dns.record](#net.dns.record)|Realiza una consulta DNS.|^|
|[net.if.collisions](#net.if.collisions)|El número de colisiones fuera de ventana.|^|
|[net.if.discovery](#net.if.discovery)|La lista de interfaces de red.|^|
|[net.if.in](#net.if.in)|Las estadísticas de tráfico entrante en una interfaz de red.|^|
|[net.if.out](#net.if.out)|Las estadísticas de tráfico saliente en una interfaz de red.|^|
|[net.if.total](#net.if.total)|La suma de las estadísticas de tráfico entrante y saliente en una interfaz de red.|^|
|[net.tcp.listen](#net.tcp.listen)|Comprueba si este puerto TCP está en estado LISTEN.|^|
|[net.tcp.port](#net.tcp.port)|Comprueba si es posible establecer una conexión TCP con el puerto especificado.|^|
|[net.tcp.service](#net.tcp.service)|Comprueba si un servicio se está ejecutando y acepta conexiones TCP.|^|
|[net.tcp.service.perf](#net.tcp.service.perf)|Comprueba el rendimiento de un servicio TCP.|^|
|[net.tcp.socket.count](#net.tcp.socket.count)|Devuelve el número de sockets TCP que coinciden con los parámetros.|^|
|[net.udp.listen](#net.udp.listen)|Comprueba si este puerto UDP está en estado LISTEN.|^|
|[net.udp.service](#net.udp.service)|Comprueba si un servicio se está ejecutando y responde a solicitudes UDP.|^|
|[net.udp.service.perf](#net.udp.service.perf)|Comprueba el rendimiento de un servicio UDP.|^|
|[net.udp.socket.count](#net.udp.socket.count)|Devuelve el número de sockets UDP que coinciden con los parámetros.|^|
|[proc.cpu.util](#proc.cpu.util)|El porcentaje de utilización de la CPU del proceso.|Procesos|
|[proc.get](#proc.get)|La lista de procesos del SO y sus parámetros.|^|
|[proc.mem](#proc.mem)|La memoria utilizada por el proceso en bytes.|^|
|[proc.num](#proc.num)|El número de procesos.|^|
|[sensor](#sensor)|Lectura de sensores de hardware.|Sensores|
|[system.boottime](#system.boottime)|La hora de arranque del sistema.|Sistema|
|[system.cpu.discovery](#system.cpu.discovery)|La lista de CPUs/núcleos de CPU detectados.|^|
|[system.cpu.intr](#system.cpu.intr)|Las interrupciones de dispositivos.|^|
|[system.cpu.load](#system.cpu.load)|La carga de la CPU.|^|
|[system.cpu.num](#system.cpu.num)|El número de CPUs.|^|
|[system.cpu.switches](#system.cpu.switches)|El recuento de cambios de contexto.|^|
|[system.cpu.util](#system.cpu.util)|El porcentaje de utilización de la CPU.|^|
|[system.hostname](#system.hostname)|El nombre del host del sistema.|^|
|[system.hw.chassis](#system.hw.chassis)|La información del chasis.|^|
|[system.hw.cpu](#system.hw.cpu)|La información de la CPU.|^|
|[system.hw.devices](#system.hw.devices)|La lista de dispositivos PCI o USB.|^|
|[system.hw.macaddr](#system.hw.macaddr)|La lista de direcciones MAC.|^|
|[system.localtime](#system.localtime)|La hora del sistema.|^|
|[system.run](#system.run)|Ejecuta el comando especificado en el host.|^|
|[system.stat](#system.stat)|Las estadísticas del sistema.|^|
|[system.sw.arch](#system.sw.arch)|La información de la arquitectura del software.|^|
|[system.sw.os](#system.sw.os)|La información del sistema operativo.|^|
|[system.sw.os.get](#system.sw.os.get)|Información detallada sobre el sistema operativo (versión, tipo, nombre de la distribución, versión menor y mayor, etc).|^|
|[system.sw.packages](#system.sw.packages)|La lista de paquetes instalados.|^|
|[system.sw.packages.get](#system.sw.packages.get)|Una lista detallada de los paquetes instalados.|^|
|[system.swap.in](#system.swap.in)|Las estadísticas de swap-in (del dispositivo a la memoria).|^|
|[system.swap.out](#system.swap.out)|Las estadísticas de swap-out (de la memoria al dispositivo).|^|
|[system.swap.size](#system.swap.size)|El tamaño del espacio de swap en bytes o en porcentaje del total.|^|
|[system.uname](#system.uname)|Identificación del sistema.|^|
|[system.uptime](#system.uptime)|El tiempo de actividad del sistema en segundos.|^|
|[system.users.num](#system.users.num)|El número de usuarios conectados.|^|
|[vfs.dev.discovery](#vfs.dev.discovery)|La lista de dispositivos de bloques y su tipo.|Sistemas de archivos virtuales|
|[vfs.dev.read](#vfs.dev.read)|Las estadísticas de lectura de disco.|^|
|[vfs.dev.write](#vfs.dev.write)|Las estadísticas de escritura de disco.|^|
|[vfs.dir.count](#vfs.dir.count)|El recuento de entradas del directorio.|^|
|[vfs.dir.get](#vfs.dir.get)|La lista de entradas del directorio.|^|
|[vfs.dir.size](#vfs.dir.size)|El tamaño del directorio.|^|
|[vfs.file.cksum](#vfs.file.cksum)|La suma de comprobación del archivo, calculada por el algoritmo UNIX cksum.|^|
|[vfs.file.contents](#vfs.file.contents)|Recuperar el contenido de un archivo.|^|
|[vfs.file.exists](#vfs.file.exists)|Comprueba si el archivo existe.|^|
|[vfs.file.get](#vfs.file.get)|Devuelve información sobre un archivo.|^|
|[vfs.file.md5sum](#vfs.file.md5sum)|La suma de comprobación MD5 del archivo.|^|
|[vfs.file.owner](#vfs.file.owner)|Recupera el propietario de un archivo.|^|
|[vfs.file.permissions](#vfs.file.permissions)|Devuelve una cadena de 4 dígitos que contiene el número octal con los permisos UNIX.|^|
|[vfs.file.regexp](#vfs.file.regexp)|Recupera una cadena en el archivo.|^|
|[vfs.file.regmatch](#vfs.file.regmatch)|Busca una cadena en el archivo.|^|
|[vfs.file.size](#vfs.file.size)|El tamaño del archivo.|^|
|[vfs.file.time](#vfs.file.time)|La información de tiempo del archivo.|^|
|[vfs.fs.discovery](#vfs.fs.discovery)|La lista de sistemas de archivos montados con su tipo y opciones de montaje.|^|
|[vfs.fs.get](#vfs.fs.get)|La lista de sistemas de archivos montados con su tipo, espacio en disco disponible, estadísticas de inodos y opciones de montaje.|^|
|[vfs.fs.inode](#vfs.fs.inode)|El número o porcentaje de inodos.|^|
|[vfs.fs.size](#vfs.fs.size)|El espacio en disco en bytes o en porcentaje del total.|^|
|[vm.memory.size](#vm.memory.size)|El tamaño de la memoria en bytes o en porcentaje del total.|Memoria virtual|
|[web.page.get](#web.page.get)|Obtiene el contenido de una página web.|Monitorización web|
|[web.page.perf](#web.page.perf)|El tiempo de carga de una página web completa.|^|
|[web.page.regexp](#web.page.regexp)|Busca una cadena en la página web.|^|
|[agent.hostmetadata](#agent.hostmetadata)|Los metadatos del host del agent.|Zabbix|
|[agent.hostname](#agent.hostname)|El nombre del host del agent.|^|
|[agent.ping](#agent.ping)|La comprobación de disponibilidad del agent.|^|
|[agent.variant](#agent.variant)|La variante del agent de Zabbix (agent de Zabbix o agent de Zabbix 2).|^|
|[agent.version](#agent.version)|La versión del agent de Zabbix.|^|
|[zabbix.stats](#zabbix.stats)|Devuelve un conjunto de métricas internas del server o proxy de Zabbix. Si se especifican `ip` y `port`, las métricas se recuperan de la instancia remota; de lo contrario, de la instancia local.|^| 
|[zabbix.stats](#zabbix.stats.two)|Devuelve el número de items monitorizados en la cola que se retrasan en el server o proxy de Zabbix. Si se especifican `ip` y `port`, las métricas se recuperan de la instancia remota; de lo contrario, de la instancia local.|^|

[comment]: # ({/3fd8c340-cefe2e1b})

[comment]: # ({07f3d331-cea3fc45})
#### Plataformas compatibles

Excepto donde se especifique lo contrario en los detalles del elemento, los elementos del agente (y todos los parámetros) son compatibles con:

-   **Linux**
-   **FreeBSD**
-   **Solaris**
-   **HP-UX**
-   **AIX**
-   **MacOS X**
-   **OpenBSD**
-   **NetBSD**

Muchos elementos del agente también son compatibles con **Windows**.
Consulte la página de [elementos del agente de Windows](/manual/config/items/itemtypes/zabbix_agent/win_keys#shared-items) para más detalles.

[comment]: # ({/07f3d331-cea3fc45})

[comment]: # ({dc120678-3077d649})
### Detalles de la clave del elemento

Los parámetros sin corchetes angulares son obligatorios.
Los parámetros marcados con corchetes angulares **<** **>** son opcionales.

[comment]: # ({/dc120678-3077d649})

[comment]: # ({39b5e2c9-20fc641c})
##### kernel.maxfiles {#kernel.maxfiles}

<br>
La cantidad máxima de archivos abiertos admitidos por el sistema operativo.<br>
Valor de retorno: *Entero*.<br>
[Plataformas compatibles](#plataformas compatibles): Linux, FreeBSD, MacOS X, OpenBSD, NetBSD.

[comment]: # ({/39b5e2c9-20fc641c})

[comment]: # ({9aaac02a-6dbdc04a})
##### kernel.maxproc {#kernel.maxproc}

<br>
El número máximo de procesos admitidos por el sistema operativo.<br>
Valor de retorno: *Entero*.<br>
[Plataformas compatibles](#plataformas compatibles): Linux 2.6 y posteriores, FreeBSD, Solaris, MacOS X, OpenBSD, NetBSD.

[comment]: # ({/9aaac02a-6dbdc04a})

[comment]: # ({725bd0fa-9f31067e})
##### kernel.openfiles {#kernel.openfiles}

<br>
El número de descriptores de archivos abiertos actualmente.<br>
Valor de retorno: *Entero*.<br>
[Plataformas compatibles](#plataformas-compatibles): Linux (el elemento puede funcionar en otras plataformas similares a UNIX).

[comment]: # ({/725bd0fa-9f31067e})

[comment]: # ({5c22a7c6-f0ef2c24})
##### log[file,<regexp>,<encoding>,<maxlines>,<mode>,<output>,<maxdelay>,<options>,<persistent dir>] {#log}

<br>
La monitorización de un archivo de log.<br>
Valor de retorno: *Log*.<br>
Consulte [plataformas compatibles](#supported-platforms).

Parámetros:

-   **file** - la ruta completa y el nombre de un archivo de log;<br>
-   **regexp** - una [expresión](/manual/regular_expressions#overview) regular que describe el patrón requerido;<br>
-   **encoding** - el [identificador](/manual/config/items/itemtypes/zabbix_agent#encoding-settings) de la página de códigos;<br>
-   **maxlines** - el número máximo de líneas nuevas por segundo que el agent enviará al Zabbix server o proxy.
Este parámetro sobrescribe el valor de 'MaxLinesPerSecond' en [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd);<br>
-   **mode** - valores posibles: *all* (predeterminado) o *skip* - omitir el procesamiento de datos antiguos (afecta solo a los items creados recientemente);<br>
-   **output** - una plantilla opcional de formato de salida.
La secuencia de escape **\\0** se sustituye por la parte del texto que coincide (desde el primer carácter donde comienza la coincidencia hasta el carácter donde termina), mientras que una secuencia de escape **\\N** (donde N=1...9) se sustituye por el grupo coincidente N-ésimo (o por una cadena vacía si N excede el número de grupos capturados);<br>
-   **maxdelay** - el retraso máximo en segundos.
Tipo: float.
Valores: 0 - (predeterminado) nunca ignorar líneas del archivo de log; > 0.0 - ignorar líneas antiguas para que las líneas más recientes se analicen dentro de "maxdelay" segundos.
¡Lea las notas sobre [maxdelay](log_items#using-maxdelay-parameter) antes de usarlo!<br>
-   **options** - opciones adicionales:<br>*mtime-noreread* - registros no únicos, releer solo si cambia el tamaño del archivo (ignorar el cambio de la hora de modificación).
(Este parámetro está obsoleto desde la versión 5.0.2, porque ahora se ignora mtime.)<br>
-   **persistent dir** (solo en zabbix\_agentd en sistemas Unix; no compatible con Zabbix agent 2) - la ruta absoluta del directorio donde almacenar archivos persistentes.
Consulte también las notas adicionales sobre [archivos persistentes](log_items#notes-on-persistent-files-for-log-items).

Comentarios:

-   El item debe configurarse como una [comprobación activa](/manual/appendix/items/activepassive#active-checks);
-   Si el archivo no existe o los permisos no permiten el acceso, el item pasa a no compatible;
-   Si `output` se deja vacío, se devuelve la línea completa que contiene el texto coincidente.
Tenga en cuenta que todos los tipos de expresiones regulares globales, excepto 'Result is TRUE', siempre devuelven la línea completa coincidente y se ignora el parámetro `output`.
-   La extracción de contenido mediante el parámetro `output` se realiza en el agent.

Ejemplos:

```default
log[/var/log/syslog]
log[/var/log/syslog,error]
log[/home/zabbix/logs/logfile,,,100]
```

Ejemplo de uso del parámetro `output` para extraer un número de un registro de log:

```default
log[/app1/app.log,"task run [0-9.]+ sec, processed ([0-9]+) records, [0-9]+ errors",,,,\1] #este item coincidirá con un registro de log "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" y enviará solo '6080' al server. Como se está enviando un valor numérico, el "Type of information" de este item puede establecerse en "Numeric (unsigned)" y el valor puede usarse en gráficos, triggers, etc.
```

Ejemplo de uso del parámetro `output` para reescribir un registro de log antes de enviarlo al server:

```default
log[/app1/app.log,"([0-9 :-]+) task run ([0-9.]+) sec, processed ([0-9]+) records, ([0-9]+) errors",,,,"\1 RECORDS: \3, ERRORS: \4, DURATION: \2"] #este item coincidirá con un registro de log "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" y enviará un registro modificado "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08" al server.
```

[comment]: # ({/5c22a7c6-f0ef2c24})

[comment]: # ({63539684-0cc87dbe})
##### log.count[file,<regexp>,<encoding>,<maxproclines>,<mode>,<maxdelay>,<options>,<persistent dir>] {#log.count}

<br>
El número de líneas coincidentes en un archivo de log monitorizado.<br>
Valor de retorno: *Integer*.<br>
Consulte [plataformas compatibles](#supported-platforms).

Parámetros:

-   **file** - la ruta completa y el nombre del archivo de log;<br>
-   **regexp** - una [expresión](/manual/regular_expressions#overview) regular que describe el patrón requerido;<br>
-   **encoding** - el [identificador](/manual/config/items/itemtypes/zabbix_agent#encoding-settings) de la página de códigos;<br>
-   **maxproclines** - el número máximo de líneas nuevas por segundo que el agent analizará (no puede superar 10000).
El valor predeterminado es 10\*'MaxLinesPerSecond' en [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd).<br>
-   **mode** - valores posibles: *all* (predeterminado) o *skip* - omitir el procesamiento de datos antiguos (afecta solo a los items creados recientemente).<br>
-   **maxdelay** - el retraso máximo en segundos.
Tipo: float.
Valores: 0 - (predeterminado) nunca ignorar líneas del archivo de log; > 0.0 - ignorar líneas antiguas para que se analicen las líneas más recientes dentro de "maxdelay" segundos.
¡Lea las notas sobre [maxdelay](log_items#using-maxdelay-parameter) antes de usarlo!<br>
-   **options** - opciones adicionales:<br>*mtime-noreread* - registros no únicos, releer solo si cambia el tamaño del archivo (ignorar el cambio de la hora de modificación).
(Este parámetro está obsoleto desde la versión 5.0.2, porque ahora se ignora mtime).<br>
-   **persistent dir** (solo en zabbix\_agentd en sistemas Unix; no compatible con Zabbix agent 2) - la ruta absoluta del directorio donde almacenar archivos persistentes.
Consulte también las notas adicionales sobre [archivos persistentes](log_items#notes-on-persistent-files-for-log-items).

Comentarios:

-   El item debe configurarse como una [comprobación activa](/manual/appendix/items/activepassive#active-checks);
-   Las líneas coincidentes se cuentan entre las líneas nuevas desde la última comprobación del log por parte del agent y, por lo tanto, dependen del intervalo de actualización del item;
-   Si el archivo no existe o los permisos no permiten el acceso, el item pasa a no compatible.

[comment]: # ({/63539684-0cc87dbe})

[comment]: # ({2b5e82b3-95734be0})
##### logrt[file regexp,<regexp>,<encoding>,<maxlines>,<mode>,<output>,<maxdelay>,<options>,<persistent dir>] {#logrt}

<br>
La monitorización de un archivo de log con rotación.<br>
Valor devuelto: *Log*.<br>
Consulte las [plataformas compatibles](#supported-platforms).

Parámetros:

-   **file regexp** - la ruta absoluta al archivo, con el nombre del archivo especificado mediante una [expresión](/manual/regular_expressions) regular.
Tenga en cuenta que la expresión regular se aplica solo al nombre del archivo y no necesita coincidir con el nombre completo (por ejemplo, /path/to/agent coincidirá con zabbix\_agentd.log).<br>
-   **regexp** - una [expresión](/manual/regular_expressions#overview) regular que describe el patrón de contenido requerido.<br>
-   **encoding** - el [identificador](/manual/config/items/itemtypes/zabbix_agent#encoding-settings) de la página de códigos.<br>
-   **maxlines** - el número máximo de líneas nuevas por segundo que el agent enviará al Zabbix server o proxy.
Este parámetro sobrescribe el valor de 'MaxLinesPerSecond' en [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd).<br>
-   **mode** - valores posibles: *all* (predeterminado) o *skip* - omitir el procesamiento de datos antiguos (afecta solo a los items creados recientemente).<br>
-   **output** - una plantilla opcional de formato de salida.
La secuencia de escape **\\0** se sustituye por la parte del texto que coincide (desde el primer carácter donde comienza la coincidencia hasta el carácter donde termina), mientras que una secuencia de escape **\\N** (donde N=1...9) se sustituye por el grupo coincidente N-ésimo (o por una cadena vacía si N supera el número de grupos capturados).<br>
-   **maxdelay** - el retraso máximo en segundos.
Tipo: float.
Valores: 0 - (predeterminado) nunca ignorar líneas del archivo de log; > 0.0 - ignorar líneas antiguas para que las líneas más recientes se analicen dentro de "maxdelay" segundos.
¡Lea las notas sobre [maxdelay](log_items#using-maxdelay-parameter) antes de usarlo!<br>
-   **options** - el tipo de rotación del archivo de log y otras opciones.
Valores posibles:<br>*rotate* (predeterminado),<br>*copytruncate* - tenga en cuenta que *copytruncate* no puede usarse junto con *maxdelay*.
En este caso, *maxdelay* debe ser 0 o no especificarse; consulte las notas sobre [copytruncate](log_items#notes-on-handling-copytruncate-log-file-rotation),<br>*mtime-reread* - registros no únicos, releer si cambia la hora de modificación o el tamaño (se usa de forma predeterminada si no se establece explícitamente ninguna opción `mtime-*`),<br>*mtime-noreread* - registros no únicos, releer solo si cambia el tamaño (ignorar el cambio de la hora de modificación).<br>
-   **persistent dir** (solo en zabbix\_agentd en sistemas Unix; no compatible con Zabbix agent 2) - la ruta absoluta del directorio donde almacenar archivos persistentes.
Consulte también las notas adicionales sobre [archivos persistentes](log_items#notes-on-persistent-files-for-log-items).

Comentarios:

-   El item debe configurarse como una [comprobación activa](/manual/appendix/items/activepassive#active-checks);
-   La rotación de logs se basa en la hora de la última modificación de los archivos;
-   Tenga en cuenta que logrt está diseñado para funcionar con un archivo de log actualmente activo y varios otros archivos inactivos coincidentes ya rotados.
Si, por ejemplo, un directorio tiene muchos archivos de log activos, debe crearse un item logrt independiente para cada uno.
De lo contrario, si un item logrt recoge demasiados archivos, puede provocar agotamiento de memoria y un fallo de la monitorización.
-   Si `output` se deja vacío, se devuelve la línea completa que contiene el texto coincidente.
Tenga en cuenta que todos los tipos de expresiones regulares globales, excepto 'Result is TRUE', siempre devuelven la línea completa coincidente y el parámetro `output` se ignora.
-   La extracción de contenido mediante el parámetro `output` se realiza en el agent.
-   En el parámetro `file regexp`, la ruta del directorio de logs y la expresión regular del archivo de log deben estar separadas por el separador de directorio correcto:  
    - en Windows, el separador debe ser una barra invertida (\\); las barras normales pueden tolerarse en otras posiciones, excepto en la que separa la ruta del directorio de logs y la expresión regular del archivo de log (consulte los ejemplos a continuación).
    - en otros sistemas, debe ser una barra normal (/).
                                            
Ejemplos para Windows:

```default
logrt["c:/dir1/dir2/dir3\filename.*\.log","pattern_to_match"] #este item recopilará datos de archivos de log en "c:/dir1/dir2/dir3" donde el nombre del archivo comienza con "filename" y termina con cualquier extensión que coincida con ".log".
logrt["//example.com/share/dir1/dir2/dir3\filename.*\.log","pattern_to_match"] #este item recopilará datos de archivos de log en el recurso compartido de red "//example.com/share/dir1/dir2/dir3" donde el nombre del archivo comienza con "filename" y termina con cualquier extensión que coincida con ".log".
```

Ejemplos para otros sistemas: 

```default
logrt["/home/zabbix/logs/^logfile[0-9]{1,3}$",,,100] #este item coincidirá con un archivo como "logfile1" (no coincidirá con ".logfile1").
logrt["/home/user/^logfile_.*_[0-9]{1,3}$","pattern_to_match","UTF-8",100] #este item recopilará datos de archivos como "logfile_abc_1" o "logfile__001".
```

Ejemplo de uso del parámetro `output` para extraer un número de un registro de log:

```default
logrt[/app1/^test.*log$,"task run [0-9.]+ sec, processed ([0-9]+) records, [0-9]+ errors",,,,\1] #este item coincidirá con un registro de log "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" y enviará solo '6080' al server. Como se está enviando un valor numérico, el "Type of information" de este item puede establecerse en "Numeric (unsigned)" y el valor puede usarse en gráficos, triggers, etc.
```

Ejemplo de uso del parámetro `output` para reescribir un registro de log antes de enviarlo al server:

```default
logrt[/app1/^test.*log$,"([0-9 :-]+) task run ([0-9.]+) sec, processed ([0-9]+) records, ([0-9]+) errors",,,,"\1 RECORDS: \3, ERRORS: \4, DURATION: \2"] #este item coincidirá con un registro de log "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" y enviará al server un registro modificado "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08".
```

[comment]: # ({/2b5e82b3-95734be0})

[comment]: # ({d5ad0a08-8ad8a2af})
##### logrt.count[file regexp,<regexp>,<encoding>,<maxproclines>,<mode>,<maxdelay>,<options>,<persistent dir>] {#logrt.count}

<br>
El recuento de líneas coincidentes en un archivo de registro monitorizado que se rota.<br>
Valor devuelto: *Integer*.<br>
Consulte [plataformas compatibles](#supported-platforms).

Parámetros:

-   **file regexp** - la ruta absoluta al archivo, con el nombre del archivo especificado mediante una [expresión](/manual/regular_expressions) regular.
Tenga en cuenta que la expresión regular se aplica solo al nombre del archivo y no necesita coincidir con el nombre completo (por ejemplo, /path/to/agent coincidirá con zabbix\_agentd.log).<br>
-   **regexp** - una [expresión](/manual/regular_expressions#overview) regular que describe el patrón requerido.<br>
-   **encoding** - el [identificador](/manual/config/items/itemtypes/zabbix_agent#encoding-settings) de la página de códigos.<br>
-   **maxproclines** - el número máximo de líneas nuevas por segundo que el agent analizará (no puede superar 10000).
El valor predeterminado es 10\*'MaxLinesPerSecond' en [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd).<br>
-   **mode** - valores posibles: *all* (predeterminado) o *skip* - omitir el procesamiento de datos antiguos (afecta solo a los items recién creados).<br>
-   **maxdelay** - el retraso máximo en segundos.
Tipo: float.
Valores: 0 - (predeterminado) nunca ignorar líneas del archivo de registro; > 0.0 - ignorar líneas antiguas para que se analicen las líneas más recientes dentro de "maxdelay" segundos.
¡Lea las notas sobre [maxdelay](log_items#using-maxdelay-parameter) antes de usarlo!<br>
-   **options** - el tipo de rotación del archivo de registro y otras opciones.
Valores posibles:<br>*rotate* (predeterminado),<br>*copytruncate* - tenga en cuenta que *copytruncate* no puede usarse junto con *maxdelay*.
En este caso, *maxdelay* debe ser 0 o no especificarse; consulte las notas sobre [copytruncate](log_items#notes-on-handling-copytruncate-log-file-rotation),<br>*mtime-reread* - registros no únicos, releer si cambia la hora de modificación o el tamaño (predeterminado),<br>*mtime-noreread* - registros no únicos, releer solo si cambia el tamaño (ignorar el cambio de la hora de modificación).<br>
-   **persistent dir** (solo en zabbix\_agentd en sistemas Unix; no compatible con Zabbix agent 2) - la ruta absoluta del directorio donde almacenar archivos persistentes.
Consulte también las notas adicionales sobre [archivos persistentes](log_items#notes-on-persistent-files-for-log-items).

Comentarios:

-   El item debe configurarse como una [comprobación activa](/manual/appendix/items/activepassive#active-checks);
-   Las líneas coincidentes se cuentan entre las líneas nuevas desde la última comprobación del registro por parte del agent y, por lo tanto, dependen del intervalo de actualización del item;
-   La rotación del registro se basa en la última hora de modificación de los archivos;
-   En el parámetro `file regexp`, la ruta del directorio de registro y la expresión regular del archivo de registro deben estar separadas por el separador de directorio correcto:  
    - en Windows, el separador debe ser una barra invertida (\\); las barras inclinadas (/) pueden tolerarse en otras posiciones, excepto en la que separa la ruta del directorio de registro y la expresión regular del archivo de registro (consulte los ejemplos a continuación).
    - en otros sistemas, debe ser una barra inclinada (/).

Ejemplos para Windows:

```default
logrt.count["c:/dir1/dir2/dir3\filename.*\.log","pattern_to_match"] #este item contará el número de coincidencias del patrón "pattern_to_match" en archivos de registro ubicados en "c:/dir1/dir2/dir3".
logrt.count["//example.com/share/dir1/dir2/dir3\filename.*\.log","pattern_to_match"] #este item contará el número de coincidencias del patrón "pattern_to_match" en archivos de registro del recurso compartido de red "//example.com/share/dir1/dir2/dir3".
```

Ejemplos para otros sistemas: 

```default
logrt.count["/home/zabbix/logs/.*","^logfile[0-9]{1,3}$",,100] #este item contará el número de coincidencias del patrón "^logfile[0-9]{1,3}$" en archivos de registro del directorio "/home/zabbix/logs".
logrt.count["/home/user/^logfile_.*_[0-9]{1,3}$","pattern_to_match","UTF-8",100] #este item contará el número de apariciones del patrón "pattern_to_match" en archivos de registro ubicados en "/home/user".
```

[comment]: # ({/d5ad0a08-8ad8a2af})

[comment]: # ({d4ecaf54-518a2dd0})
##### modbus.get[endpoint,<slave id>,<function>,<address>,<count>,<type>,<endianness>,<offset>] {#modbus}

<br>
Lee datos de Modbus.<br>
Valor devuelto: *objeto JSON*.<br>
[Plataformas soportadas](#supported-platforms): Linux, Windows.

Parámetros:

-   **endpoint** - el endpoint definido como `protocol://connection_string`;<br>
-   **slave id** - el ID del esclavo;<br>
-   **function** - la función Modbus;<br>
-   **address** - la dirección del primer registro, bobina o entrada;<br>
-   **count** - el número de registros a leer;<br>
-   **type** - el tipo de datos;<br>
-   **endianness** - la configuración de endianness;<br>
-   **offset** - el número de registros, comenzando desde 'address', cuyos resultados serán descartados.

En Windows, este item sigue rutas UNC en el parámetro **endpoint**, lo que puede ser un [riesgo de seguridad](/manual/best_practices/security/access_control#unc-path-access-on-windows-by-zabbix-agent);

Consulte una [descripción detallada](/manual/appendix/items/modbus) de los parámetros.

[comment]: # ({/d4ecaf54-518a2dd0})

[comment]: # ({599b71f4-ba7da5e1})
##### net.dns[<ip>,name,<tipo>,<timeout>,<count>,<protocol>] {#net.dns}

<br>
Comprueba el estado de un servicio DNS.<br>
Valores de retorno: 0 - la resolución DNS falló (el servidor DNS no respondió o devolvió un error); 1 - la resolución DNS tuvo éxito.<br>
Consulte las [plataformas compatibles](#supported-platforms).

Parámetros:

-   **ip** (ignorado en Windows a menos que se utilice Zabbix agent 2): la dirección IP del servidor DNS (dejar vacío para el servidor DNS por defecto);
-   **name**: el nombre DNS a consultar;
-   **type**: el tipo de registro a consultar (por defecto es *SOA*);
-   **timeout** (ignorado en Windows a menos que se utilice Zabbix agent 2): el tiempo de espera para la solicitud en segundos (por defecto es 1 segundo);
-   **count** (ignorado en Windows a menos que se utilice Zabbix agent 2): el número de intentos para la solicitud (por defecto es 2);
-   **protocol**: el protocolo utilizado para realizar las consultas DNS: *udp* (por defecto) o *tcp*.

Comentarios:

-   Los valores posibles para `type` son: *ANY*, *A*, *NS*, *CNAME*, *MB*, *MG*, *MR*, *PTR*, *MD*, *MF*, *MX*, *SOA*, *NULL*, *WKS* (no compatible con Zabbix agent en Windows, Zabbix agent 2 en todos los SO), *HINFO*, *MINFO*, *TXT*, *SRV*
-   Para búsquedas DNS inversas (cuando `type` se establece en *PTR*), puede proporcionar el nombre DNS tanto en formato invertido como no invertido (vea los ejemplos a continuación).
Tenga en cuenta que cuando se solicita un registro PTR, el nombre DNS es en realidad una dirección IP.
-   Los nombres de dominio internacionalizados no son compatibles, utilice nombres codificados en IDNA en su lugar.

Ejemplos:

```default
net.dns[198.51.100.1,example.com,MX,2,1]

net.dns[,198.51.100.1,PTR]
net.dns[,1.100.51.198.in-addr.arpa,PTR]

net.dns[,2a00:1450:400f:800::200e,PTR]
net.dns[,e.0.0.2.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.0.f.0.0.4.0.5.4.1.0.0.a.2.ip6.arpa,PTR]
```

[comment]: # ({/599b71f4-ba7da5e1})

[comment]: # ({78b9fae7-ea9e0739})
##### net.dns.perf[<ip>,name,<type>,<timeout>,<count>,<protocol>] {#net.dns.perf}

<br>
Comprueba el rendimiento de un servicio DNS.<br>
Valor de retorno: *Flotante* (0 - el servicio está caído; segundos - el número de segundos que se tarda en recibir una respuesta del servicio).<br>
Consulte las [plataformas compatibles](#supported-platforms).

Parámetros:

-   **ip** (ignorado en Windows a menos que se utilice Zabbix agent 2): la dirección IP del servidor DNS (dejar vacío para el servidor DNS por defecto);
-   **name**: el nombre DNS a consultar;
-   **type**: el tipo de registro a consultar (por defecto es *SOA*);
-   **timeout** (ignorado en Windows a menos que se utilice Zabbix agent 2): el tiempo de espera para la solicitud en segundos (por defecto es 1 segundo);
-   **count** (ignorado en Windows a menos que se utilice Zabbix agent 2): el número de intentos para la solicitud (por defecto es 2);
-   **protocol**: el protocolo utilizado para realizar las consultas DNS: *udp* (por defecto) o *tcp*.

Comentarios:

-   Los valores posibles para `type` son:<br>*ANY*, *A*, *NS*, *CNAME*, *MB*, *MG*, *MR*, *PTR*, *MD*, *MF*, *MX*, *SOA*, *NULL*, *WKS* (no soportado para Zabbix agent en Windows, Zabbix agent 2 en todos los SO), *HINFO*, *MINFO*, *TXT*, *SRV*
-   Para búsquedas DNS inversas (cuando `type` se establece en *PTR*), puede proporcionar el nombre DNS tanto en formato invertido como no invertido (vea los ejemplos a continuación).
Tenga en cuenta que cuando se solicita un registro PTR, el nombre DNS es en realidad una dirección IP.
-   Los nombres de dominio internacionalizados no son compatibles, utilice nombres codificados en IDNA en su lugar.
-   Desde Zabbix 7.0.1, el elemento devuelve un tiempo de respuesta en lugar de `0` cuando el servidor DNS responde con un código de error (por ejemplo, `NXDOMAIN` o `SERVFAIL`).

Ejemplos:

```default
net.dns.perf[198.51.100.1,example.com,MX,2,1]

net.dns.perf[,198.51.100.1,PTR]
net.dns.perf[,1.100.51.198.in-addr.arpa,PTR]

net.dns.perf[,2a00:1450:400f:800::200e,PTR]
net.dns.perf[,e.0.0.2.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.0.f.0.0.4.0.5.4.1.0.0.a.2.ip6.arpa,PTR]
```

[comment]: # ({/78b9fae7-ea9e0739})

[comment]: # ({86f73efb-d5dc268a})
##### net.dns.record[<ip>,name,<type>,<timeout>,<count>,<protocol>] {#net.dns.record}

<br>
Realiza una consulta DNS.<br>

Zabbix agent 2 también proporciona [net.dns.get](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#net.dns.get), que ofrece funciones adicionales como más tipos de registros y mayor control sobre la monitorización DNS.
Valor de retorno: una cadena de caracteres con el tipo de información requerida.<br>
Consulte [plataformas compatibles](#supported-platforms).

Parámetros:

-   **ip** (ignorado en Windows a menos que se utilice Zabbix agent 2): la dirección IP del servidor DNS (dejar vacío para el servidor DNS por defecto);
-   **name**: el nombre DNS a consultar;
-   **type**: el tipo de registro a consultar (por defecto es *SOA*);
-   **timeout** (ignorado en Windows a menos que se utilice Zabbix agent 2): el tiempo de espera para la solicitud en segundos (por defecto es 1 segundo);
-   **count** (ignorado en Windows a menos que se utilice Zabbix agent 2): el número de intentos para la solicitud (por defecto es 2);
-   **protocol**: el protocolo utilizado para realizar consultas DNS: *udp* (por defecto) o *tcp*.

Comentarios:

-   Los valores posibles para `type` son:<br>*ANY*, *A*, *NS*, *CNAME*, *MB*, *MG*, *MR*, *PTR*, *MD*, *MF*, *MX*, *SOA*, *NULL*, *WKS* (no soportado para Zabbix agent en Windows, Zabbix agent 2 en todos los SO), *HINFO*, *MINFO*, *TXT*, *SRV*
-   Para búsquedas DNS inversas (cuando `type` se establece en *PTR*), puede proporcionar el nombre DNS en formato invertido o no invertido (vea los ejemplos a continuación).
Tenga en cuenta que cuando se solicita un registro PTR, el nombre DNS es en realidad una dirección IP.
-   Los nombres de dominio internacionalizados no son compatibles, utilice nombres codificados en IDNA en su lugar.

Ejemplos:

```default
net.dns.record[198.51.100.1,example.com,MX,2,1]

net.dns.record[,198.51.100.1,PTR]
net.dns.record[,1.100.51.198.in-addr.arpa,PTR]

net.dns.record[,2a00:1450:400f:800::200e,PTR]
net.dns.record[,e.0.0.2.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.0.f.0.0.4.0.5.4.1.0.0.a.2.ip6.arpa,PTR]
```

[comment]: # ({/86f73efb-d5dc268a})

[comment]: # ({3bbd623d-1e07380f})
##### net.if.collisions[if] {#net.if.collisions}

<br>
El número de colisiones fuera de ventana.<br>
Valor de retorno: *Entero*.<br>
[Plataformas soportadas](#supported-platforms): Linux, FreeBSD, Solaris, AIX, MacOS X, OpenBSD, NetBSD.
Se requieren privilegios de root en NetBSD.

Parámetro:

-   **if** - nombre de la interfaz de red

[comment]: # ({/3bbd623d-1e07380f})

[comment]: # ({08eb686e-8911d171})
##### net.if.discovery {#net.if.discovery}

<br>
La lista de interfaces de red.
Utilizado para el descubrimiento de bajo nivel.<br>
Valor de retorno: *objeto JSON*.<br>
[Plataformas soportadas](#supported-platforms): Linux, FreeBSD, Solaris, HP-UX, AIX, OpenBSD, NetBSD, Windows.

[comment]: # ({/08eb686e-8911d171})

[comment]: # ({abe11167-e53ce465})
##### net.if.in[if,<mode>] {#net.if.in}

<br>
Las estadísticas de tráfico entrante en una interfaz de red.<br>
Valor de retorno: *Integer*.<br>
[Plataformas soportadas](#supported-platforms): Linux, FreeBSD, Solaris^**[5](#footnotes)**^, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows.
Se requieren privilegios de root en NetBSD.

Parámetros:

-   **if** - nombre de la interfaz de red (Unix); descripción completa de la interfaz de red o dirección IPv4; o, si está entre llaves, GUID de la interfaz de red (Windows);
-   **mode** - valores posibles:<br>*bytes* - número de bytes (por defecto)<br>*packets* - número de paquetes<br>*errors* - número de errores<br>*dropped* - número de paquetes descartados<br>*overruns (fifo)* - número de errores de búfer FIFO<br>*frame* - número de errores de enmarcado de paquetes<br>*compressed* - número de paquetes comprimidos recibidos por el controlador del dispositivo<br>*multicast* - número de tramas multicast recibidas por el controlador del dispositivo

Comentarios:

-   Puede usar esta clave con el paso de preprocesamiento *Cambio por segundo* para obtener estadísticas de bytes por segundo;
-   El modo *dropped* solo es compatible con Linux, FreeBSD, HP-UX, MacOS X, OpenBSD, NetBSD;
-   Los modos *overruns*, *frame*, *compressed*, *multicast* solo son compatibles con Linux;
-   En HP-UX este item no proporciona detalles sobre interfaces de loopback (por ejemplo, lo0).

Ejemplos:

```default
net.if.in[eth0]
net.if.in[eth0,errors]
```

[comment]: # ({/abe11167-e53ce465})

[comment]: # ({b622fbac-ab67e043})
##### net.if.out[if,<mode>] {#net.if.out}

<br>
Las estadísticas de tráfico saliente en una interfaz de red.<br>
Valor de retorno: *Integer*.<br>
[Plataformas soportadas](#supported-platforms): Linux, FreeBSD, Solaris^**[5](#footnotes)**^, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows.
Se requieren privilegios de root en NetBSD.

Parámetros:

-   **if** - nombre de la interfaz de red (Unix); descripción completa de la interfaz de red o dirección IPv4; o, si está entre llaves, GUID de la interfaz de red (Windows);
-   **mode** - valores posibles:<br>*bytes* - número de bytes (por defecto)<br>*packets* - número de paquetes<br>*errors* - número de errores<br>*dropped* - número de paquetes descartados<br>*overruns (fifo)* - número de errores de búfer FIFO<br>*collisions (colls)* - número de colisiones detectadas en la interfaz<br>*carrier* - número de pérdidas de portadora detectadas por el controlador del dispositivo<br>*compressed* - número de paquetes comprimidos transmitidos por el controlador del dispositivo

Comentarios:

-   Puede usar esta clave con el paso de preprocesamiento *Cambio por segundo* para obtener las estadísticas de bytes por segundo;
-   El modo *dropped* solo se admite en Linux, HP-UX;
-   Los modos *overruns*, *collision*, *carrier*, *compressed* solo se admiten en Linux;
-   En HP-UX este item no proporciona detalles sobre las interfaces de loopback (por ejemplo, lo0).

Ejemplos:

```default
net.if.out[eth0]
net.if.out[eth0,errors]
```

[comment]: # ({/b622fbac-ab67e043})

[comment]: # ({e1079e2c-3c96d291})
##### net.if.total[if,<mode>] {#net.if.total}

<br>
La suma de las estadísticas de tráfico entrante y saliente en una interfaz de red.<br>
Valor devuelto: *Integer*.<br>
[Plataformas soportadas](#supported-platforms): Linux, FreeBSD, Solaris^**[5](#footnotes)**^, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows.
Se requieren privilegios de root en NetBSD.

Parámetros:

-   **if** - nombre de la interfaz de red (Unix); descripción completa de la interfaz de red o dirección IPv4; o, si está entre llaves, GUID de la interfaz de red (Windows);
-   **mode** - valores posibles:<br>*bytes* - número de bytes (por defecto)<br>*packets* - número de paquetes<br>*errors* - número de errores<br>*dropped* - número de paquetes descartados<br>*overruns (fifo)* - número de errores de buffer FIFO<br>*collisions (colls)* - número de colisiones detectadas en la interfaz<br>*compressed* - número de paquetes comprimidos transmitidos o recibidos por el controlador del dispositivo

Comentarios:

-   Puede utilizar esta clave con el paso de preprocesamiento *Change per second* para obtener las estadísticas de bytes por segundo;
-   El modo *dropped* solo es compatible con Linux, HP-UX.
Los paquetes descartados solo son compatibles si tanto `net.if.in` como `net.if.out` funcionan para los paquetes descartados en su plataforma.
-   Los modos *overruns*, *collision*, *compressed* solo son compatibles con Linux;
-   En HP-UX este item no proporciona detalles sobre las interfaces de loopback (por ejemplo, lo0).

Ejemplos:

```default
net.if.total[eth0]
net.if.total[eth0,errors]
```

[comment]: # ({/e1079e2c-3c96d291})

[comment]: # ({2f569538-a72f9721})
##### net.tcp.listen[port] {#net.tcp.listen}

<br>
Comprueba si este puerto TCP está en estado LISTEN.<br>
Valores de retorno: 0 - no está en estado LISTEN; 1 - está en estado LISTEN.<br>
[Plataformas soportadas](#supported-platforms): Linux, FreeBSD, Solaris, MacOS X, Windows.

Parámetro:

-   **port** - número de puerto TCP

En los kernels de Linux 2.6.14 y superiores, la información sobre los sockets TCP en escucha se obtiene de la interfaz NETLINK del kernel, si es posible.
De lo contrario, la información se recupera de los archivos /proc/net/tcp y /roc/net/tcp6.

Ejemplo:

```default
net.tcp.listen[80]
```

[comment]: # ({/2f569538-a72f9721})

[comment]: # ({40c963e3-000f516d})
##### net.tcp.port[<ip>,puerto] {#net.tcp.port}

<br>
Comprueba si es posible establecer una conexión TCP al puerto especificado.<br>
Valores de retorno: 0 - no se puede conectar; 1 - se puede conectar.<br>
Consulte las [plataformas compatibles](#supported-platforms).

Parámetros:

-   **ip**: la dirección IP o el nombre DNS (por defecto es 127.0.0.1);
-   **puerto**: el número de puerto.

Comentarios:

-   Para pruebas simples de rendimiento TCP utilice `net.tcp.service.perf[tcp,<ip>,<puerto>]`;
-   Estas comprobaciones pueden generar mensajes adicionales en los archivos de registro del sistema (normalmente se registran sesiones SMTP y SSH).

Ejemplo:

```default
net.tcp.port[,80] #este elemento puede usarse para probar la disponibilidad del servidor web que se ejecuta en el puerto 80
```

[comment]: # ({/40c963e3-000f516d})

[comment]: # ({b810edae-11ca536e})
##### net.tcp.service[service,<ip>,<puerto>] {#net.tcp.service}

<br>
Comprueba si un servicio está en ejecución y acepta conexiones TCP.<br>
Valores de retorno: 0 - el servicio está caído; 1 - el servicio está en ejecución.<br>
Consulte las [plataformas compatibles](#supported-platforms).

Parámetros:

-   **service** - *ssh*, *ldap*, *smtp*, *ftp*, *http*, *pop*, *nntp*, *imap*, *tcp*, *https* o *telnet* (consulte [detalles](/manual/appendix/items/service_check_details));
-   **ip** - la dirección IP o el nombre DNS (por defecto es 127.0.0.1);
-   **port** - el número de puerto (por defecto se utiliza el número de puerto estándar del servicio).

Comentarios:

-   Estas comprobaciones pueden generar mensajes adicionales en los archivos de registro del sistema (normalmente se registran sesiones SMTP y SSH);
-   Actualmente no se admite la comprobación de protocolos cifrados (como IMAP en el puerto 993 o POP en el puerto 995).
Como solución alternativa, utilice `net.tcp.port[]` para comprobaciones como estas.
-   La comprobación de LDAP y HTTPS en Windows solo es compatible con Zabbix agent 2;
-   La comprobación de telnet busca un mensaje de inicio de sesión (':' al final).

Ejemplo:

```default
net.tcp.service[ftp,,45] #este elemento puede usarse para probar la disponibilidad de un servidor FTP en el puerto TCP 45
```

[comment]: # ({/b810edae-11ca536e})

[comment]: # ({4bb92b46-49a8f9ac})
##### net.tcp.service.perf[service,<ip>,<puerto>] {#net.tcp.service.perf}

<br>
Comprueba el rendimiento de un servicio TCP.<br>
Valores de retorno: *Flotante* (0 - el servicio está caído; segundos - el número de segundos que se tarda en esperar una respuesta del servicio).<br>
Consulte las [plataformas compatibles](#supported-platforms).

Parámetros:

-   **service** - *ssh*, *ldap*, *smtp*, *ftp*, *http*, *pop*, *nntp*, *imap*, *tcp*, *https* o *telnet* (consulte [detalles](/manual/appendix/items/service_check_details));
-   **ip** - la dirección IP o el nombre DNS (por defecto es 127.0.0.1);
-   **puerto** - el número de puerto (por defecto se utiliza el número de puerto estándar del servicio).

Comentarios:

-   Actualmente no se admite la comprobación de protocolos cifrados (como IMAP en el puerto 993 o POP en el puerto 995).
Como solución alternativa, utilice `net.tcp.service.perf[tcp,<ip>,<puerto>]` para comprobaciones como estas.
-   La comprobación de telnet busca un aviso de inicio de sesión (':' al final).

Ejemplo:

```default
net.tcp.service.perf[ssh] #este elemento puede utilizarse para probar la velocidad de la respuesta inicial del servidor SSH
```

[comment]: # ({/4bb92b46-49a8f9ac})

[comment]: # ({ea50d3fb-29fba160})
##### net.tcp.socket.count[<laddr>,<lport>,<raddr>,<rport>,<state>] {#net.tcp.socket.count}

<br>
Devuelve el número de sockets TCP que coinciden con los parámetros.<br>
Valor devuelto: *Entero*.<br>
[Plataformas compatibles](#supported-platforms): Linux, Windows.

Parámetros:

-   **laddr** - la dirección IPv4/6 local o subred CIDR;
-   **lport** - el número de puerto local o nombre de servicio;
-   **raddr** - la dirección IPv4/6 remota o subred CIDR;
-   **rport** - el número de puerto remoto o nombre de servicio;
-   **state** - el estado de la conexión (*established*, *syn\_sent*, *syn\_recv*, *fin\_wait1*, *fin\_wait2*, *time\_wait*, *close*, *close\_wait*, *last\_ack*, *listen*, *closing*).

Ejemplo:

```default
net.tcp.socket.count[,80,,,established] #el número de conexiones al puerto TCP local 80 en estado established
```

[comment]: # ({/ea50d3fb-29fba160})

[comment]: # ({ae22cf5b-b9f198f7})
##### net.udp.listen[puerto] {#net.udp.listen}

<br>
Comprueba si este puerto UDP está en estado LISTEN.<br>
Valores de retorno: 0 - no está en estado LISTEN; 1 - está en estado LISTEN.<br>
[Plataformas soportadas](#supported-platforms): Linux, FreeBSD, Solaris, MacOS X.

Parámetro:

-   **puerto** - número de puerto UDP

Ejemplo:

```default
net.udp.listen[68]
```

[comment]: # ({/ae22cf5b-b9f198f7})

[comment]: # ({c9e3662b-7c60892f})
##### net.udp.service[service,<ip>,<puerto>] {#net.udp.service}

<br>
Comprueba si un servicio está en ejecución y responde a solicitudes UDP.<br>
Valores de retorno: 0 - el servicio está caído; 1 - el servicio está en ejecución.<br>
Consulte las [plataformas compatibles](#supported-platforms).

Parámetros:

-   **service** - *ntp* (ver [detalles](/manual/appendix/items/service_check_details));
-   **ip** - la dirección IP o el nombre DNS (por defecto es 127.0.0.1);
-   **puerto** - el número de puerto (por defecto se utiliza el número de puerto estándar del servicio).

Ejemplo:

```default
net.udp.service[ntp,,45] #este ítem puede usarse para probar la disponibilidad del servicio NTP en el puerto UDP 45
```

[comment]: # ({/c9e3662b-7c60892f})

[comment]: # ({e00eff59-8697ef9c})
##### net.udp.service.perf[service,<ip>,<puerto>] {#net.udp.service.perf}

<br>
Comprueba el rendimiento de un servicio UDP.<br>
Valores de retorno: *Flotante* (0 - el servicio está caído; segundos - el número de segundos que se ha esperado la respuesta del servicio).<br>
Consulte las [plataformas compatibles](#supported-platforms).

Parámetros:

-   **service** - *ntp* (ver [detalles](/manual/appendix/items/service_check_details));
-   **ip** - la dirección IP o el nombre DNS (por defecto es 127.0.0.1);
-   **puerto** - el número de puerto (por defecto se utiliza el número de puerto estándar del servicio).

Ejemplo:

```default
net.udp.service.perf[ntp] #este elemento puede usarse para probar el tiempo de respuesta del servicio NTP
```

[comment]: # ({/e00eff59-8697ef9c})

[comment]: # ({a220d1e6-25a2206c})
##### net.udp.socket.count[<laddr>,<lport>,<raddr>,<rport>,<state>] {#net.udp.socket.count}

<br>
Devuelve el número de sockets UDP que coinciden con los parámetros.<br>
Valor devuelto: *Entero*.<br>
[Plataformas soportadas](#supported-platforms): Linux, Windows.

Parámetros:

-   **laddr** - la dirección IPv4/6 local o subred CIDR;
-   **lport** - el número de puerto local o nombre de servicio;
-   **raddr** - la dirección IPv4/6 remota o subred CIDR;
-   **rport** - el número de puerto remoto o nombre de servicio;
-   **state** - el estado de la conexión (*established*, *unconn*).

Ejemplo:

```default
net.udp.socket.count[,,,,established] #devuelve el número de sockets UDP en estado conectado
```

[comment]: # ({/a220d1e6-25a2206c})

[comment]: # ({9ea97b28-4c3ddb55})
##### proc.cpu.util[<nombre>,<usuario>,<tipo>,<línea_comando>,<modo>,<zona>] {#proc.cpu.util}

<br>
El porcentaje de utilización de CPU del proceso.<br>
Valor de retorno: *Float*.<br>
[Plataformas compatibles](#supported-platforms): Linux, Solaris^**[6](#footnotes)**^.

Parámetros:

-   **nombre**: el nombre del proceso (por defecto, *todos los procesos*);
-   **usuario**: el nombre de usuario (por defecto, *todos los usuarios*);
-   **tipo**: el tipo de utilización de CPU: *total* (por defecto), *user* o *system*;
-   **línea_comando**: filtrar por línea de comando (es una [expresión regular](/manual/regular_expressions#overview));
-   **modo**: el modo de recopilación de datos: *avg1* (por defecto), *avg5* o *avg15*;
-   **zona**: la zona objetivo: *current* (por defecto) o *all*.
Este parámetro solo es compatible con Solaris.

Comentarios:

-   El valor devuelto se basa en el porcentaje de utilización de un solo núcleo de CPU.
Por ejemplo, la utilización de CPU de un proceso que utiliza completamente dos núcleos es del 200%.
-   Los datos de utilización de CPU del proceso se recopilan mediante un recolector que admite un máximo de 1024 consultas únicas (por nombre, usuario y línea de comando).
Las consultas que no se hayan accedido en las últimas 24 horas se eliminan del recolector.
-   Al establecer el parámetro `zona` en *current* (o por defecto), en caso de que el agente se haya compilado en un Solaris sin soporte de zonas, pero se esté ejecutando en un Solaris más reciente donde se admiten zonas, el agente devolverá NOTSUPPORTED (el agente no puede limitar los resultados solo a la zona actual).
Sin embargo, *all* es compatible en este caso.

Ejemplos:

```default
proc.cpu.util[,root] #Utilización de CPU de todos los procesos ejecutados bajo el usuario "root"
proc.cpu.util[zabbix_server,zabbix] #Utilización de CPU de todos los procesos zabbix_server ejecutados bajo el usuario zabbix
```

[comment]: # ({/9ea97b28-4c3ddb55})

[comment]: # ({6aaa3575-02480d9a})
##### proc.get[<nombre>,<usuario>,<línea de comandos>,<modo>] {#proc.get}

<br>
La lista de procesos del sistema operativo y sus parámetros.
Puede utilizarse para el descubrimiento de bajo nivel.<br>
Valor de retorno: *objeto JSON*.<br>
[Plataformas compatibles](#supported-platforms): Linux, FreeBSD, Windows, OpenBSD, NetBSD.

Parámetros:

-   **nombre**: el nombre del proceso (por defecto *todos los procesos*);
-   **usuario**: el nombre de usuario (por defecto *todos los usuarios*);
-   **línea de comandos**: filtrar por línea de comandos (es una [expresión regular](/manual/regular_expressions#overview)).
Este parámetro no es compatible con Windows; en otras plataformas no es compatible si el modo está establecido en 'summary'.
-   **modo**: valores posibles:<br>*process* (por defecto), *thread* (no compatible con NetBSD), *summary*.
Consulte la lista de [parámetros de proceso](/manual/appendix/items/proc_get) devueltos para cada modo y sistema operativo.

Comentarios:

-   Si no se puede recuperar un valor, por ejemplo, debido a un error (el proceso ya ha terminado, falta de permisos, fallo de llamada al sistema), se devolverá `-1`;
-   Consulte las [notas](/manual/appendix/items/proc_mem_num_notes) sobre la selección de procesos con los parámetros `nombre` y `línea de comandos` (específico de Linux).

Ejemplos:

```default
proc.get[zabbix_server,zabbix,,process] #lista de todos los procesos zabbix_server ejecutándose bajo el usuario zabbix, devuelve una entrada por PID
proc.get[java,,,thread] #lista de todos los procesos Java, devuelve una entrada por hilo
proc.get[,zabbix,,summary] #datos combinados para los procesos de cada tipo ejecutándose bajo el usuario zabbix, devuelve una entrada por nombre de proceso
```

[comment]: # ({/6aaa3575-02480d9a})

[comment]: # ({00ea1ea2-d3e42b1a})
##### proc.mem[<nombre>,<usuario>,<modo>,<línea_comando>,<tipomem>] {#proc.mem}

<br>
La memoria utilizada por el proceso en bytes.<br>
Valor de retorno: *Entero* - con `modo` como *max*, *min*, *sum*; *Flotante* - con `modo` como *avg*<br>
[Plataformas soportadas](#supported-platforms): Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.

Parámetros:

-   **nombre**: el nombre del proceso (por defecto, *todos los procesos*);
-   **usuario**: el nombre de usuario (por defecto, *todos los usuarios*);
-   **modo**: valores posibles: *avg*, *max*, *min* o *sum* (por defecto);
-   **línea_comando**: filtrar por línea de comandos (es una [expresión regular](/manual/regular_expressions#overview));
-   **tipomem**: el [tipo de memoria](/manual/appendix/items/proc_mem_notes) utilizada por el proceso

Comentarios:

-   El parámetro `tipomem` solo es compatible con Linux, FreeBSD, Solaris^**[6](#footnotes)**^, AIX;
-   Cuando varios procesos utilizan memoria compartida, la suma de la memoria utilizada por los procesos puede dar como resultado valores grandes e irreales.<br><br>Consulte las [notas](/manual/appendix/items/proc_mem_num_notes) sobre la selección de procesos con los parámetros `nombre` y `línea_comando` (específico de Linux).<br><br>Cuando este elemento se invoca desde la línea de comandos y contiene un parámetro de línea de comandos (por ejemplo, usando el modo de prueba del agente: `zabbix_agentd -t proc.mem[,,,apache2]`), se contará un proceso adicional, ya que el agente se contará a sí mismo.

Ejemplos:

```default
proc.mem[,root] #la memoria utilizada por todos los procesos ejecutados bajo el usuario "root"
proc.mem[zabbix_server,zabbix] #la memoria utilizada por todos los procesos zabbix_server ejecutados bajo el usuario zabbix
proc.mem[,oracle,max,oracleZABBIX] #la memoria utilizada por el proceso que más memoria consume ejecutado bajo Oracle y que tenga oracleZABBIX en su línea de comandos
```

[comment]: # ({/00ea1ea2-d3e42b1a})

[comment]: # ({5f0c2dc1-8e6bf30e})
##### proc.num[<name>,<user>,<state>,<cmdline>,<zone>] {#proc.num}

<br>
El número de procesos.<br>
Valor de retorno: *Entero*.<br>
[Plataformas soportadas](#supported-platforms): Linux, FreeBSD, Solaris^**[6](#footnotes)**^, HP-UX, AIX, OpenBSD, NetBSD, Windows.

Parámetros:

-   **name** - el nombre del proceso (por defecto *todos los procesos*);
-   **user** - el nombre de usuario (por defecto *todos los usuarios*);
-   **state** - valores posibles:<br>*all* (por defecto),<br>*disk* - sueño ininterrumpible,<br>*run* - ejecutándose,<br>*sleep* - sueño interrumpible,<br>*trace* - detenido,<br>*zomb* - zombi;
-   **cmdline** - filtrar por línea de comandos (es una [expresión regular](/manual/regular_expressions#overview));
-   **zone** - la zona objetivo: *current* (por defecto), o *all*.
Este parámetro solo se soporta en Solaris.

Comentarios:

-   Los parámetros de estado *disk* y *trace* solo se soportan en Linux, FreeBSD, OpenBSD, NetBSD;
-   En Windows, solo se soportan los parámetros `name` y `user`;
-   Cuando este item se invoca desde la línea de comandos y contiene un parámetro de línea de comandos (por ejemplo, usando el modo de prueba del agent: `zabbix_agentd -t proc.num[,,,apache2]`), se contará un proceso extra, ya que el agent se contará a sí mismo;
-   Cuando se establece el parámetro `zone` en *current* (o por defecto) en caso de que el agent se haya compilado en un Solaris sin soporte de zonas, pero se ejecute en un Solaris más reciente donde se soportan zonas, entonces el agent devolverá NOTSUPPORTED (el agent no puede limitar los resultados solo a la zona actual).
Sin embargo, *all* está soportado en este caso.
-   Consulte las [notas](/manual/appendix/items/proc_mem_num_notes) sobre la selección de procesos con los parámetros `name` y `cmdline` (específico de Linux).

Ejemplos:

```default
proc.num[,mysql] #el número de procesos ejecutándose bajo el usuario mysql
proc.num[apache2,www-data] #el número de procesos apache2 ejecutándose bajo el usuario www-data
proc.num[,oracle,sleep,oracleZABBIX] #el número de procesos en estado sleep ejecutándose bajo Oracle que tengan oracleZABBIX en su línea de comandos
```

[comment]: # ({/5f0c2dc1-8e6bf30e})

[comment]: # ({7a39c690-7cdd8214})
##### sensor[device,sensor,<mode>] {#sensor}

<br>
Lectura del sensor de hardware.<br>
Valor devuelto: *Float*.<br>
[Plataformas compatibles](#supported-platforms): Linux, OpenBSD.

Parámetros:

-   **device** - el nombre del dispositivo;
-   **sensor** - el nombre del sensor;
-   **mode** - valores posibles: *avg*, *max* o *min*.

Comentarios:

-   Lee /proc/sys/dev/sensors en Linux 2.4;
-   Lee /sys/class/hwmon en Linux 2.6+.
Consulte una descripción más detallada del item [sensor](/manual/appendix/items/sensor) en Linux;
-   Lee el MIB *hw.sensors* en OpenBSD;
-   En Linux 2.4, si especifica mode, entonces device y sensor se tratan como expresiones regulares;  
-   En Linux 2.6+ y OpenBSD, o si se omite mode, device y sensor se tratan literalmente.

Ejemplos:

```default
sensor[w83781d-i2c-0-2d,temp1]
sensor[cpu0,temp0] #the temperature of one CPU
sensor["cpu[0-2]$",temp,avg] #the average temperature of the first three CPUs
```

[comment]: # ({/7a39c690-7cdd8214})

[comment]: # ({e9d6ac0b-f46449fd})

##### sistema.tiempo de arranque {#sistema.tiempo de arranque}

<br>
La hora de inicio del sistema.<br>
Valor de retorno: *Entero (marca de tiempo Unix)*.<br>
[Plataformas compatibles](#plataformas compatibles): Linux, FreeBSD, Solaris, MacOS X, OpenBSD, NetBSD.

[comment]: # ({/e9d6ac0b-f46449fd})

[comment]: # ({fbfe668c-b01f71c5})
##### system.cpu.discovery {#system.cpu.discovery}

<br>
La lista de CPUs/núcleos de CPU detectados.
Se utiliza para el descubrimiento de bajo nivel.<br>
Valor de retorno: *objeto JSON*.<br>
Consulte las [plataformas compatibles](#supported-platforms).

[comment]: # ({/fbfe668c-b01f71c5})

[comment]: # ({10a8dca8-956c4ef9})

##### system.cpu.intr {#system.cpu.intr}

<br>
El dispositivo se interrumpe.<br>
Valor de retorno: *Entero*.<br>
[Plataformas compatibles](#plataformas compatibles): Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.

[comment]: # ({/10a8dca8-956c4ef9})

[comment]: # ({6c32a6cf-c8c74d92})
##### system.cpu.load[<cpu>,<modo>] {#system.cpu.load}

<br>
La [carga de CPU](http://en.wikipedia.org/wiki/Load_(computing)).<br>
Valor de retorno: *Flotante*.<br>
Consulte las [plataformas compatibles](#supported-platforms).

Parámetros:

-   **cpu**: valores posibles: *all* (por defecto) o *percpu* (la carga total dividida por el número de CPUs en línea);
-   **modo**: valores posibles: *avg1* (promedio de un minuto, por defecto), *avg5* o *avg15*.

Ejemplo:

```default
system.cpu.load[,avg5]
```

[comment]: # ({/6c32a6cf-c8c74d92})

[comment]: # ({86d05d2e-e110ddf9})
##### system.cpu.num[<type>] {#system.cpu.num}

<br>
El número de CPUs.<br>
Valor devuelto: *Integer*.<br>
[Plataformas soportadas](#supported-platforms): Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows.

Parámetro:

-   **type** - valores posibles: *online* (por defecto) o *max*

El parámetro de tipo *max* solo es compatible con Linux, FreeBSD, Solaris, MacOS X.

Ejemplo: 

```default
system.cpu.num
```

[comment]: # ({/86d05d2e-e110ddf9})

[comment]: # ({43d94c7f-addfe1ba})

##### sistema.cpu.conmutadores {#sistema.cpu.conmutadores}

<br>
El recuento de cambios de contexto.<br>
Valor de retorno: *Entero*.<br>
[Plataformas compatibles](#plataformas compatibles): Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.

[comment]: # ({/43d94c7f-addfe1ba})

[comment]: # ({85535844-d1abd90a})
##### system.cpu.util[<cpu>,<type>,<mode>,<logical or physical>] {#system.cpu.util}

<br>
El porcentaje de utilización de la CPU.<br>
Valor devuelto: *Float*.<br>
[Plataformas soportadas](#supported-platforms): Linux, FreeBSD, Solaris, HP-UX, AIX, OpenBSD, NetBSD, Windows.

Parámetros:

-   **cpu** - *<número de CPU>* o *all* (por defecto);
-   **type** - valores posibles: *user* (por defecto), *idle*, *nice*, *system*, *iowait*, *interrupt*, *softirq*, *steal*, *guest* (en kernels Linux 2.6.24 y superiores), o *guest\_nice* (en kernels Linux 2.6.33 y superiores);
-   **mode** - valores posibles: *avg1* (media de un minuto, por defecto), *avg5*, o *avg15*;
-   **logical or physical** - valores posibles: *logical* (por defecto) o *physical*.
Este parámetro solo se soporta en AIX.

Comentarios:

-   El parámetro de tipo *nice* solo se soporta en Linux, FreeBSD, HP-UX, OpenBSD, NetBSD.
-   El parámetro de tipo *iowait* solo se soporta en Linux 2.6 y superiores, Solaris, AIX.
-   El parámetro de tipo *interrupt* solo se soporta en Linux 2.6 y superiores, FreeBSD, OpenBSD.
-   Los parámetros de tipo *softirq*, *steal*, *guest*, *guest_nice* solo se soportan en Linux 2.6 y superiores.
-   Los parámetros de modo *avg5* y *avg15* se soportan en Linux, FreeBSD, Solaris, HP-UX, AIX, OpenBSD, NetBSD.

Ejemplo:

```default
system.cpu.util[0,user,avg5]
```

[comment]: # ({/85535844-d1abd90a})

[comment]: # ({da2f7667-05f3200c})
##### system.hostname[<type>,<transform>] {#system.hostname}

<br>
El nombre de host del sistema.<br>
Valor de retorno: *Cadena*.<br>
Consulte las [plataformas compatibles](#supported-platforms).

Parámetros:

-   **type** - valores posibles: *netbios* (por defecto en Windows), *host* (por defecto en Linux), *shorthost* (devuelve la parte del nombre de host antes del primer punto, una cadena completa para nombres sin puntos), *fqdn* (devuelve el Nombre de Dominio Totalmente Calificado);
-   **transform** - valores posibles: *none* (por defecto) o *lower* (convierte a minúsculas).

El valor se obtiene tomando `nodename` de la salida de la API del sistema uname().

Ejemplos de valores devueltos:

```default
system.hostname → linux-w7x1
system.hostname → example.com
system.hostname[shorthost] → example
system.hostname → WIN-SERV2008-I6
system.hostname[host] → Win-Serv2008-I6LonG
system.hostname[host,lower] → win-serv2008-i6long
system.hostname[fqdn,lower] → blog.zabbix.com
```

[comment]: # ({/da2f7667-05f3200c})

[comment]: # ({829bfadb-d14d8400})
##### system.hw.chassis[<info>] {#system.hw.chassis}

<br>
La información del chasis.<br>
Valor de retorno: *Cadena*.<br>
[Plataformas compatibles](#supported-platforms): Linux.

Parámetro:

-   **info**: valores posibles: *full* (por defecto), *model*, *serial*, *type* o *vendor*

Comentarios:

-   Esta clave de elemento depende de la disponibilidad de la tabla [SMBIOS](http://en.wikipedia.org/wiki/System_Management_BIOS);
-   Intentará leer la tabla DMI desde sysfs, si el acceso a sysfs falla, intentará leer directamente de la memoria;
-   Se requieren **permisos de root** porque el valor se obtiene leyendo desde sysfs o memoria.

Ejemplo:

```default
system.hw.chassis[full] → Hewlett-Packard HP Pro 3010 Small Form Factor PC CZXXXXXXXX Desktop
```

[comment]: # ({/829bfadb-d14d8400})

[comment]: # ({359280f5-33f13e22})
##### system.hw.cpu[<cpu>,<info>] {#system.hw.cpu}

<br>
La información de la CPU.<br>
Valor de retorno: *Cadena* o *Entero*.<br>
[Plataformas compatibles](#supported-platforms): Linux.

Parámetros:

-   **cpu** - *<Número de CPU>* o *all* (por defecto);
-   **info** - valores posibles: *full* (por defecto), *curfreq*, *maxfreq*, *model* o *vendor*.

Comentarios:

-   Recopila información de `/proc/cpuinfo` y `/sys/devices/system/cpu/[cpunum]/cpufreq/cpuinfo_max_freq`;
-   Si se especifica un número de CPU y *curfreq* o *maxfreq*, se devuelve un valor numérico (Hz).

Ejemplo:

```default
system.hw.cpu[0,vendor] → AuthenticAMD
```

[comment]: # ({/359280f5-33f13e22})

[comment]: # ({82b6b82e-87688787})
##### system.hw.devices[<tipo>] {#system.hw.devices}

<br>
La lista de dispositivos PCI o USB.<br>
Valor de retorno: *Texto*.<br>
[Plataformas compatibles](#supported-platforms): Linux.

Parámetro:

-   **tipo** - *pci* (por defecto) o *usb*

Devuelve la salida de la utilidad lspci o lsusb (ejecutada sin ningún parámetro).

Ejemplo:

```default
system.hw.devices → 00:00.0 Host bridge: Advanced Micro Devices [AMD] RS780 Host Bridge
```

[comment]: # ({/82b6b82e-87688787})

[comment]: # ({e398211b-ee01b8b4})
##### system.hw.macaddr[<interfaz>,<formato>] {#system.hw.macaddr}

<br>
El listado de direcciones MAC.<br>
Valor de retorno: *Cadena*.<br>
[Plataformas compatibles](#supported-platforms): Linux.

Parámetros:

-   **interfaz** - *all* (por defecto) o una [expresión](/manual/regular_expressions#overview) regular;
-   **formato** - *full* (por defecto) o *short*

Comentarios:

-   Lista las direcciones MAC de las interfaces cuyo nombre coincide con la [expresión](/manual/regular_expressions#overview) regular `interfaz` dada (*all* lista para todas las interfaces);
-   Si `formato` se especifica como *short*, no se listan los nombres de las interfaces ni las direcciones MAC idénticas.

Ejemplo:

```default
system.hw.macaddr["eth0$",full] → [eth0] 00:11:22:33:44:55
```

[comment]: # ({/e398211b-ee01b8b4})

[comment]: # ({a6bc1582-1729b15d})
##### system.localtime[<type>] {#system.localtime}

<br>
La hora del sistema.<br>
Valor de retorno: *Integer* - con `type` como *utc*; *String* - con `type` como *local*.<br>
Consulte [plataformas compatibles](#supported-platforms).

Parámetros:

-   **type** - valores posibles: *utc* - (predeterminado) el tiempo transcurrido desde la Época (00:00:00 UTC, 1 de enero de 1970), medido en segundos, o *local* - la hora en el formato 'yyyy-mm-dd,hh:mm:ss.nnn,+hh:mm'

Debe utilizarse como una [comprobación pasiva](/manual/appendix/items/activepassive#passive-checks) para Zabbix agent; en Zabbix agent 2 puede configurarse como una comprobación activa.

Ejemplo:

```default
system.localtime[local] #cree un item usando esta clave y luego utilícelo para mostrar la hora del host en el widget de panel *Clock*.
```

[comment]: # ({/a6bc1582-1729b15d})

[comment]: # ({84cbfb96-806250ba})
##### system.run[command,<mode>] {#system.run}

<br>
Ejecuta el comando especificado en el host.<br>
Valor de retorno: *Texto* resultado del comando o 1 - con `mode` como *nowait* (independientemente del resultado del comando).<br>
Consulte las [plataformas compatibles](#supported-platforms).

Parámetros:

-   **command** - comando a ejecutar;<br>
-   **mode** - valores posibles: *wait* - esperar al final de la ejecución (por defecto) o *nowait* - no esperar.

Comentarios:

-   Este ítem está deshabilitado por defecto.
Aprenda cómo [habilitarlos](/manual/config/items/restrict_checks);
-   El valor de retorno del ítem es la salida estándar junto con el error estándar producido por el comando.
No se realiza la [comprobación del código de salida](/manual/appendix/command_execution#exit-code-checking);
-   Para ser procesado correctamente, el valor de retorno del comando debe ser de tipo de datos `text`.
También se permite un resultado vacío;
-   El valor de retorno está limitado a 16MB (incluyendo los espacios en blanco finales que se truncan); también se aplican los [límites de la base de datos](/manual/config/items/item#text-data-limits);
-   Véase también: [Ejecución de comandos](/manual/appendix/command_execution).

Ejemplo:

```default
system.run[ls -l /] #devuelve una lista detallada de archivos del directorio raíz
```

[comment]: # ({/84cbfb96-806250ba})

[comment]: # ({1ab49bd1-ed8aa2a2})
##### system.stat[resource,<type>] {#system.stat}

<br>
Las estadísticas del sistema.<br>
Valor de retorno: *Entero* o *flotante*.<br>
[Plataformas compatibles](#supported-platforms): AIX.

Parámetros:

-   **ent**: el número de unidades de procesador que esta partición tiene derecho a recibir (flotante);
-   **kthr,<type>**: información sobre los estados de los hilos del núcleo:<br>*r*: número promedio de hilos del núcleo ejecutables (flotante)<br>*b*: número promedio de hilos del núcleo colocados en la cola de espera del Administrador de Memoria Virtual (flotante)
-   **memory,<type>**: información sobre el uso de la memoria virtual y real:<br>*avm*: páginas virtuales activas (entero)<br>*fre*: tamaño de la lista libre (entero)
-   **page,<type>**: información sobre fallos de página y actividad de paginación:<br>*fi*: páginas de archivos leídas por segundo (flotante)<br>*fo*: páginas de archivos escritas por segundo (flotante)<br>*pi*: páginas paginadas desde el espacio de paginación (flotante)<br>*po*: páginas paginadas al espacio de paginación (flotante)<br>*fr*: páginas liberadas (reemplazo de página) (flotante)<br>*sr*: páginas escaneadas por el algoritmo de reemplazo de página (flotante)
-   **faults,<type>**: tasa de interrupciones y traps:<br>*in*: interrupciones de dispositivos (flotante)<br>*sy*: llamadas al sistema (flotante)<br>*cs*: cambios de contexto de hilos del núcleo (flotante)
-   **cpu,<type>**: desglose del porcentaje de uso del tiempo del procesador:<br>*us*: tiempo de usuario (flotante)<br>*sy*: tiempo de sistema (flotante)<br>*id*: tiempo inactivo (flotante)<br>*wa*: tiempo inactivo durante el cual el sistema tenía solicitudes de E/S de disco/NFS pendientes (flotante)<br>*pc*: número de procesadores físicos consumidos (flotante)<br>*ec*: porcentaje de capacidad asignada consumida (flotante)<br>*lbusy*: indica el porcentaje de utilización de procesadores lógicos que ocurrió mientras se ejecutaba a nivel de usuario y de sistema (flotante)<br>*app*: indica los procesadores físicos disponibles en el pool compartido (flotante)
-   **disk,<type>**: estadísticas de disco:<br>*bps*: indica la cantidad de datos transferidos (leídos o escritos) a la unidad en bytes por segundo (entero)<br>*tps*: indica el número de transferencias por segundo que se emitieron al disco/tape físico (flotante)

Comentarios:

-   Tenga en cuenta las siguientes limitaciones en estos elementos:<br>
    `system.stat[cpu,app]`: solo compatible en AIX LPAR de tipo "Shared"<br>
    `system.stat[cpu,ec]`: compatible en AIX LPAR de tipo "Shared" y "Dedicated" ("Dedicated" siempre devuelve 100 (por ciento))<br>
    `system.stat[cpu,lbusy]`: solo compatible en AIX LPAR de tipo "Shared"<br>
    `system.stat[cpu,pc]`: compatible en AIX LPAR de tipo "Shared" y "Dedicated"<br>
    `system.stat[ent]`: compatible en AIX LPAR de tipo "Shared" y "Dedicated"

[comment]: # ({/1ab49bd1-ed8aa2a2})

[comment]: # ({a425b76d-087e6420})
##### system.sw.arch {#system.sw.arch}

<br>
La información de la arquitectura del software.<br>
Valor de retorno: *Cadena*.<br>
Consulte [plataformas compatibles](#supported-platforms).

La información se obtiene de la función `uname()`.

Ejemplo:

```default
system.sw.arch → i686
```

[comment]: # ({/a425b76d-087e6420})

[comment]: # ({49a57063-ed818157})
##### system.sw.os[<info>] {#system.sw.os}

<br>
La información del sistema operativo.<br>
Valor de retorno: *Cadena*.<br>
[Plataformas compatibles](#supported-platforms): Linux, Windows.

Parámetro:

-   **info**: valores posibles: *full* (por defecto), *short* o *name*

La información se obtiene de (tenga en cuenta que no todos los archivos y opciones están presentes en todas las distribuciones):

-   `/proc/version` (*full*) en Linux;
-   `/proc/version_signature` (*short*) en Linux;
-   el parámetro PRETTY_NAME de `/etc/os-release` en sistemas Linux que lo soporten o `/etc/issue.net` (*name*);
-   la clave de registro ``HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion`` en Windows.

Ejemplos:

```default
system.sw.os[short] → Ubuntu 2.6.35-28.50-generic 2.6.35.11
system.sw.os[full] → [s|Windows 10 Enterprise 22621.1.asd64fre.ni_release.220506-1250 Build 22621.963]
```

[comment]: # ({/49a57063-ed818157})

[comment]: # ({e125942e-38e87471})

##### sistema.sw.os.get {#sistema.sw.os.get}

<br>
Información detallada sobre el sistema operativo (versión, tipo, nombre de distribución, versión menor y mayor, etc.).<br>
Valor de retorno: *objeto JSON*.<br>
[Plataformas compatibles](#plataformas-compatibles): Linux, Windows.

[comment]: # ({/e125942e-38e87471})

[comment]: # ({594444c2-bc2ee313})
##### system.sw.packages[<regexp>,<manager>,<format>] {#system.sw.packages}

<br>
La lista de paquetes instalados.<br>
Valor de retorno: *Texto*.<br>
[Plataformas compatibles](#supported-platforms): Linux.

Parámetros:

-   **regexp** - *all* (por defecto) o una [expresión](/manual/regular_expressions#overview) regular;
-   **manager** - *all* (por defecto) o un gestor de paquetes;
-   **format** - *full* (por defecto) o *short*.

Comentarios:

-   Enumera (alfabéticamente) los paquetes instalados cuyo nombre coincide con la [expresión](/manual/regular_expressions#overview) regular dada (*all* los enumera todos);
-   Gestores de paquetes compatibles (comando ejecutado):<br>dpkg (dpkg --get-selections)<br>pkgtool (ls /var/log/packages)<br>rpm (rpm -qa)<br>pacman (pacman -Q)<br>portage
-   Si `format` se especifica como *full*, los paquetes se agrupan por gestores de paquetes (cada gestor en una línea separada que comienza con su nombre entre corchetes);
-   Si `format` se especifica como *short*, los paquetes no se agrupan y se enumeran en una sola línea.

Ejemplo:

```default
system.sw.packages[mini,dpkg,short] → python-minimal, python2.6-minimal, ubuntu-minimal
```

[comment]: # ({/594444c2-bc2ee313})

[comment]: # ({f596138e-43f5d666})

##### system.sw.packages.get[<regexp>,<administrador>] {#system.sw.packages.get}

<br>
Una lista detallada de los paquetes instalados.<br>
Valor de retorno: *objeto JSON*.<br>
[Plataformas compatibles](#plataformas-compatibles): Linux.

Parámetros:

- **regexp** - *todos* (predeterminado) o una [expresión] normal (/manual/regular_expressions#overview);
- **manager** - *all* (predeterminado) o un administrador de paquetes (valores posibles: *rpm*, *dpkg*, *pkgtool*, *pacman* o *portage*).

Comentarios:

- Devuelve JSON sin formato con los paquetes instalados cuyo nombre coincide con la expresión regular dada;
- El resultado es una matriz de objetos, cada uno de los cuales contiene las siguientes claves: nombre, administrador, versión, tamaño, arquitectura, tiempo de compilación y tiempo de instalación (consulte [más detalles](/manual/appendix/items/return_values_system_sw_packages_get)).

[comment]: # ({/f596138e-43f5d666})

[comment]: # ({640e6b41-b0c4a5e8})
##### system.swap.in[<dispositivo>,<tipo>] {#system.swap.in}

<br>
Las estadísticas de swap-in (del dispositivo a la memoria).<br>
Valor de retorno: *Entero*.<br>
[Plataformas compatibles](#supported-platforms): Linux, FreeBSD, OpenBSD.

Parámetros:

-   **dispositivo**: especifica el dispositivo utilizado para el intercambio (solo Linux) o *all* (por defecto);
-   **tipo**: valores posibles: *count* (número de swapins, por defecto en plataformas que no son Linux), *sectors* (sectores intercambiados), o *pages* (páginas intercambiadas, por defecto en Linux).

Comentarios:

-   La fuente de esta información es:<br>/proc/swaps, /proc/partitions, /proc/stat (Linux 2.4)<br>/proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6)
-   Tenga en cuenta que *pages* solo funcionará si no se especificó el dispositivo;
-   El parámetro de tipo *sectors* solo es compatible con Linux.

Ejemplo:

```default
system.swap.in[,pages]
```

[comment]: # ({/640e6b41-b0c4a5e8})

[comment]: # ({bc3b1823-6cc86983})
##### system.swap.out[<dispositivo>,<tipo>] {#system.swap.out}

<br>
Las estadísticas de intercambio hacia fuera (de la memoria al dispositivo).<br>
Valor de retorno: *Entero*.<br>
[Plataformas compatibles](#supported-platforms): Linux, FreeBSD, OpenBSD.

Parámetros:

-   **dispositivo**: especifica el dispositivo utilizado para el intercambio (solo Linux) o *all* (por defecto);
-   **tipo**: valores posibles: *count* (número de intercambios, por defecto en plataformas que no sean Linux), *sectors* (sectores intercambiados), o *pages* (páginas intercambiadas, por defecto en Linux).

Comentarios:

-   La fuente de esta información es:<br>`/proc/swaps`, `/proc/partitions`, `/proc/stat` (Linux 2.4)<br>`/proc/swaps`, `/proc/diskstats`, `/proc/vmstat` (Linux 2.6)
-   Tenga en cuenta que *pages* solo funcionará si no se especificó el dispositivo;
-   El parámetro de tipo *sectors* solo es compatible con Linux.

Ejemplo:

```default
system.swap.out[,pages]
```

[comment]: # ({/bc3b1823-6cc86983})

[comment]: # ({89e3a043-5815bd72})
##### system.swap.size[<device>,<type>] {#system.swap.size}

<br>
El tamaño del espacio de swap en bytes o en porcentaje del total.<br>
Valor devuelto: *Integer* - para bytes; *Float* - para porcentaje.<br>
[Plataformas soportadas](#supported-platforms): Linux, FreeBSD, Solaris, AIX, OpenBSD, Windows.

Parámetros:

-   **device** - especifica el dispositivo utilizado para swap (solo FreeBSD) o *all* (por defecto);
-   **type** - valores posibles: *free* (espacio de swap libre, por defecto), *pfree* (espacio de swap libre, en porcentaje), *pused* (espacio de swap usado, en porcentaje), *total* (espacio de swap total), o *used* (espacio de swap usado).

Comentarios:

-   Tenga en cuenta que *pfree*, *pused* no son compatibles en Windows si el tamaño de swap es 0;
-   Si no se especifica el dispositivo, el agent de Zabbix solo tendrá en cuenta los dispositivos de swap (archivos), la memoria física será ignorada.
Por ejemplo, en sistemas Solaris el comando `swap -s` incluye una porción de memoria física y dispositivos de swap (a diferencia de `swap -l`).

Ejemplo:

```default
system.swap.size[,pfree] → porcentaje de espacio de swap libre
```

[comment]: # ({/89e3a043-5815bd72})

[comment]: # ({cb1e7147-6ceb79d2})
##### system.uname {#system.uname}

<br>
Identificación del sistema.<br>
Valor de retorno: *Cadena*.<br>
Consulte las [plataformas compatibles](#supported-platforms).

Comentarios:

-   En UNIX, el valor de este elemento se obtiene con la llamada al sistema uname();
-   En Windows, el elemento devuelve la arquitectura del SO, mientras que en UNIX devuelve la arquitectura de la CPU.

Ejemplos:

```default
system.uname → FreeBSD localhost 4.2-RELEASE FreeBSD 4.2-RELEASE #0: Mon Nov i386
system.uname → Windows ZABBIX-WIN 6.0.6001 Microsoft® Windows Server® 2008 Standard Service Pack 1 x86
```

[comment]: # ({/cb1e7147-6ceb79d2})

[comment]: # ({5ebb3397-545f6370})
##### system.uptime {#system.uptime}

<br>
El tiempo de actividad del sistema en segundos.<br>
Valor devuelto: *Entero*.<br>
[Plataformas soportadas](#supported-platforms): Linux, FreeBSD, Solaris, AIX, MacOS X, OpenBSD, NetBSD, Windows.

En la [configuración del item](/manual/config/items/item#configuration), utilice las unidades **s** o **uptime** para obtener valores legibles.

[comment]: # ({/5ebb3397-545f6370})

[comment]: # ({18cfe8a9-c03c81d9})

##### sistema.usuarios.num {#sistema.usuarios.num}

<br>
El número de usuarios que iniciaron sesión.<br>
Valor de retorno: *Entero*.<br>
Consulte [plataformas compatibles](#plataformas-compatibles).

El comando **who** se utiliza en el lado del agente para obtener el valor.

[comment]: # ({/18cfe8a9-c03c81d9})

[comment]: # ({e3b2cdd5-48d7b263})
##### vfs.dev.discovery {#vfs.dev.discovery}

<br>
La lista de dispositivos de bloques y su tipo.
Se utiliza para el descubrimiento de bajo nivel.<br>
Valor de retorno: *objeto JSON*.<br>
[Plataformas compatibles](#supported-platforms): Linux.

[comment]: # ({/e3b2cdd5-48d7b263})

[comment]: # ({5a5cba69-bde9774e})
##### vfs.dev.read[<dispositivo>,<tipo>,<modo>] {#vfs.dev.read}

<br>
Las estadísticas de lectura de disco.<br>
Valor de retorno: *Entero* - con `tipo` en *sectors*, *operations*, *bytes*; *Flotante* - con `tipo` en *sps*, *ops*, *bps*.<br>
[Plataformas soportadas](#supported-platforms): Linux, FreeBSD, Solaris, AIX, OpenBSD.

Parámetros:

-   **dispositivo** - dispositivo de disco (por defecto es *all* ^**[3](#footnotes)**^);
-   **tipo** - valores posibles: *sectors*, *operations*, *bytes*, *sps*, *ops* o *bps* (*sps*, *ops*, *bps* significan: sectores, operaciones, bytes por segundo, respectivamente);
-   **modo** - valores posibles: *avg1* (promedio de un minuto, por defecto), *avg5* o *avg15*.
Este parámetro solo se admite con `tipo` en: sps, ops, bps.

Comentarios:

-   Si se utiliza un intervalo de actualización de tres horas o más^**[2](#footnotes)**^, este elemento siempre devolverá '0';
-   Los parámetros de tipo *sectors* y *sps* solo se admiten en Linux;
-   El parámetro de tipo *ops* solo se admite en Linux y FreeBSD;
-   El parámetro de tipo *bps* solo se admite en FreeBSD;
-   El parámetro de tipo *bytes* solo se admite en FreeBSD, Solaris, AIX, OpenBSD;
-   El parámetro `modo` solo se admite en Linux, FreeBSD;
-   Puede utilizar nombres de dispositivos relativos (por ejemplo, `sda`) así como un prefijo opcional /dev/ (por ejemplo, `/dev/sda`);
-   Se admiten volúmenes lógicos LVM;
-   Los valores por defecto del parámetro 'tipo' para diferentes SO:<br>*AIX* - operations<br>*FreeBSD* - bps<br>*Linux* - sps<br>*OpenBSD* - operations<br>*Solaris* - bytes
-   *sps*, *ops* y *bps* en plataformas soportadas están limitados a 1024 dispositivos (1023 individuales y uno para *all*).

Ejemplo:

```default
vfs.dev.read[,operations]
```

[comment]: # ({/5a5cba69-bde9774e})

[comment]: # ({ef4aa6f7-beef0883})
##### vfs.dev.write[<dispositivo>,<tipo>,<modo>] {#vfs.dev.write}

<br>
Las estadísticas de escritura en disco.<br>
Valor de retorno: *Entero* - con `tipo` en *sectors*, *operations*, *bytes*; *Flotante* - con `tipo` en *sps*, *ops*, *bps*.<br>
[Plataformas compatibles](#supported-platforms): Linux, FreeBSD, Solaris, AIX, OpenBSD.

Parámetros:

-   **dispositivo** - dispositivo de disco (por defecto es *all* ^**[3](#footnotes)**^);
-   **tipo** - valores posibles: *sectors*, *operations*, *bytes*, *sps*, *ops* o *bps* (*sps*, *ops*, *bps* significan: sectores, operaciones, bytes por segundo, respectivamente);
-   **modo** - valores posibles: *avg1* (promedio de un minuto, por defecto), *avg5* o *avg15*.
Este parámetro solo es compatible con `tipo` en: sps, ops, bps.

Comentarios:

-   Si se utiliza un intervalo de actualización de tres horas o más^**[2](#footnotes)**^, este elemento siempre devolverá '0';
-   Los parámetros de tipo *sectors* y *sps* solo son compatibles en Linux;
-   El parámetro de tipo *ops* solo es compatible en Linux y FreeBSD;
-   El parámetro de tipo *bps* solo es compatible en FreeBSD;
-   El parámetro de tipo *bytes* solo es compatible en FreeBSD, Solaris, AIX, OpenBSD;
-   El parámetro `modo` solo es compatible en Linux, FreeBSD;
-   Puede utilizar nombres de dispositivos relativos (por ejemplo, `sda`) así como un prefijo opcional /dev/ (por ejemplo, `/dev/sda`);
-   Se admiten volúmenes lógicos LVM;
-   Los valores por defecto del parámetro 'tipo' para diferentes SO:<br>*AIX* - operations<br>*FreeBSD* - bps<br>*Linux* - sps<br>*OpenBSD* - operations<br>*Solaris* - bytes
-   *sps*, *ops* y *bps* en plataformas compatibles están limitados a 1024 dispositivos (1023 individuales y uno para *all*).

Ejemplo:

```default
vfs.dev.write[,operations]
```

[comment]: # ({/ef4aa6f7-beef0883})

[comment]: # ({8abe9d9f-a28e06f9})
##### vfs.dir.count[dir,<regex incl>,<regex excl>,<types incl>,<types excl>,<max depth>,<min size>,<max size>,<min age>,<max age>,<regex excl dir>] {#vfs.dir.count}

<br>
El recuento de entradas del directorio.<br>
Valor devuelto: *Integer*.<br>
Consulte las [plataformas compatibles](#supported-platforms).

Parámetros:

-   **dir** - la ruta absoluta al directorio;
-   **regex incl** - una [expresión](/manual/regular_expressions#overview) regular que describe el patrón de nombre de la entidad (archivo, directorio, enlace simbólico) que se debe incluir; incluye todas si está vacío (valor predeterminado);
-   **regex excl** - una [expresión](/manual/regular_expressions#overview) regular que describe el patrón de nombre de la entidad (archivo, directorio, enlace simbólico) que se debe excluir; no excluye ninguna si está vacío (valor predeterminado);
-   **types incl** - tipos de entradas de directorio que se deben contar, valores posibles: *file* - archivo regular, *dir* - subdirectorio, *sym* - enlace simbólico, *sock* - socket, *bdev* - dispositivo de bloques, *cdev* - dispositivo de caracteres, *fifo* - FIFO, *dev* - sinónimo de "bdev,cdev", *all* - todos los tipos (predeterminado), es decir, "file,dir,sym,sock,bdev,cdev,fifo".
Los tipos múltiples deben separarse con comas y entrecomillarse.
-   **types excl** - tipos de entradas de directorio (consulte `types incl`) que NO se deben contar.
Si algún tipo de entrada está tanto en `types incl` como en `types excl`, las entradas de directorio de este tipo NO se cuentan.
-   **max depth** - la profundidad máxima de subdirectorios que se debe recorrer:<br>**-1** (predeterminado) - ilimitada,<br>**0** - no descender a subdirectorios.
-   **min size** - el tamaño mínimo (en bytes) para que un archivo sea contado.
Los archivos más pequeños no se contarán.
Se pueden usar [sufijos de memoria](/manual/appendix/suffixes#memory-size-suffixes).
-   **max size** - el tamaño máximo (en bytes) para que un archivo sea contado.
Los archivos más grandes no se contarán.
Se pueden usar [sufijos de memoria](/manual/appendix/suffixes#memory-size-suffixes).
-   **min age** - la antigüedad mínima (en segundos) de la entrada de directorio para que sea contada.
Las entradas más recientes no se contarán.
Se pueden usar [sufijos de tiempo](/manual/appendix/suffixes#time-suffixes).
-   **max age** - la antigüedad máxima (en segundos) de la entrada de directorio para que sea contada.
Las entradas con esa antigüedad o mayor no se contarán (hora de modificación).
Se pueden usar [sufijos de tiempo](/manual/appendix/suffixes#time-suffixes).
-   **regex excl dir** - una [expresión](/manual/regular_expressions#overview) regular que describe el patrón de nombre del directorio que se debe excluir.
Se excluirá todo el contenido del directorio (a diferencia de regex\_excl)

Comentarios:

-   En Windows, este item sigue rutas UNC, lo que puede representar un [riesgo de seguridad](/manual/best_practices/security/access_control#unc-path-access-on-windows-by-zabbix-agent);
-   Las variables de entorno, por ejemplo %APP_HOME%, $HOME y %TEMP%, no son compatibles;
-   Los pseudodirectorios "." y ".." nunca se cuentan;
-   Los enlaces simbólicos nunca se siguen al recorrer directorios;
-   Tanto `regex incl` como `regex excl` se aplican a archivos y directorios al calcular el recuento de entradas, pero se ignoran al seleccionar los subdirectorios que se deben recorrer (si `regex incl` es "(?i)\^.+\\.zip$" y `max depth` no está establecido, entonces se recorrerán todos los subdirectorios, pero solo se contarán los archivos de tipo zip).
-   El tiempo de ejecución está limitado por el valor de timeout en la [configuración](/manual/appendix/config/zabbix_agentd#timeout) del agent (3 s).
Dado que el recorrido de directorios grandes puede tardar más que eso, no se devolverán datos y el item pasará a no ser compatible.
No se devolverá un recuento parcial.
-   Al filtrar por tamaño, solo los archivos regulares tienen tamaños significativos.
En Linux y BSD, los directorios también tienen tamaños distintos de cero (normalmente unos pocos KB).
Los dispositivos tienen tamaño cero; por ejemplo, el tamaño de **/dev/sda1** no refleja el tamaño de la partición correspondiente.
Por lo tanto, al usar `<min_size>` y `<max_size>`, es recomendable especificar `<types_incl>` como "*file*" para evitar resultados inesperados.

Ejemplos:

```default
vfs.dir.count[/dev] #supervisa el número de dispositivos en /dev (Linux)
vfs.dir.count["C:\Users\ADMINI~1\AppData\Local\Temp"] #supervisa el número de archivos en un directorio temporal
```

[comment]: # ({/8abe9d9f-a28e06f9})

[comment]: # ({82ed1999-4a354b20})
##### vfs.dir.get[dir,<regex incl>,<regex excl>,<types incl>,<types excl>,<max depth>,<min size>,<max size>,<min age>,<max age>,<regex excl dir>] {#vfs.dir.get}

<br>
La lista de entradas del directorio.<br>
Valor devuelto: *objeto JSON*.<br>
Consulte [plataformas compatibles](#supported-platforms).

Parámetros:

-   **dir** - la ruta absoluta al directorio;
-   **regex incl** - una [expresión](/manual/regular_expressions#overview) regular que describe el patrón de nombre de la entidad (archivo, directorio, enlace simbólico) que se debe incluir; incluye todo si está vacío (valor predeterminado);
-   **regex excl** - una [expresión](/manual/regular_expressions#overview) regular que describe el patrón de nombre de la entidad (archivo, directorio, enlace simbólico) que se debe excluir; no excluye nada si está vacío (valor predeterminado);
-   **types incl** - tipos de entradas de directorio que se deben listar; valores posibles: *file* - archivo regular, *dir* - subdirectorio, *sym* - enlace simbólico, *sock* - socket, *bdev* - dispositivo de bloques, *cdev* - dispositivo de caracteres, *fifo* - FIFO, *dev* - sinónimo de "bdev,cdev", *all* - todos los tipos (predeterminado), es decir, "file,dir,sym,sock,bdev,cdev,fifo".
Los tipos múltiples deben separarse con comas y entre comillas.
-   **types excl** - tipos de entradas de directorio (consulte `types incl`) que NO se deben listar.
Si algún tipo de entrada está tanto en `types incl` como en `types excl`, las entradas de directorio de este tipo NO se listarán.
-   **max depth** - la profundidad máxima de subdirectorios que se recorrerá:<br>**-1** (predeterminado) - ilimitada,<br>**0** - sin descender a subdirectorios.
-   **min size** - el tamaño mínimo (en bytes) para que un archivo se liste.
Los archivos más pequeños no se listarán.
Se pueden usar [sufijos de memoria](/manual/appendix/suffixes#memory-size-suffixes).
-   **max size** - el tamaño máximo (en bytes) para que un archivo se liste.
Los archivos más grandes no se listarán.
Se pueden usar [sufijos de memoria](/manual/appendix/suffixes#memory-size-suffixes).
-   **min age** - la antigüedad mínima (en segundos) de la entrada de directorio para que se liste.
Las entradas más recientes no se listarán.
Se pueden usar [sufijos de tiempo](/manual/appendix/suffixes#time-suffixes).
-   **max age** - la antigüedad máxima (en segundos) de la entrada de directorio para que se liste.
Las entradas con esa antigüedad o mayor no se listarán (hora de modificación).
Se pueden usar [sufijos de tiempo](/manual/appendix/suffixes#time-suffixes).
-   **regex excl dir** - una [expresión](/manual/regular_expressions#overview) regular que describe el patrón de nombre del directorio que se debe excluir.
Todo el contenido del directorio será excluido (a diferencia de `regex excl`)

Comentarios:

-   En Windows, este item sigue rutas UNC, lo que puede representar un [riesgo de seguridad](/manual/best_practices/security/access_control#unc-path-access-on-windows-by-zabbix-agent);
-   Las variables de entorno, por ejemplo %APP_HOME%, $HOME y %TEMP%, no son compatibles;
-   Los pseudodirectorios "." y ".." nunca se listan;
-   Los enlaces simbólicos nunca se siguen para el recorrido de directorios;
-   Tanto `regex incl` como `regex excl` se aplican a archivos y directorios al generar la lista de entradas, pero se ignoran al seleccionar los subdirectorios que se recorrerán (si `regex incl` es "(?i)\^.+\\.zip$" y `max depth` no está establecido, entonces se recorrerán todos los subdirectorios, pero solo se contarán los archivos de tipo zip).
-   El tiempo de ejecución está limitado por el valor de timeout en la [configuración](/manual/appendix/config/zabbix_agentd#timeout) del agent.
Dado que el recorrido de directorios grandes puede tardar más que eso, no se devolverán datos y el item pasará a no compatible.
No se devolverá una lista parcial.
-   Al filtrar por tamaño, solo los archivos regulares tienen tamaños significativos.
En Linux y BSD, los directorios también tienen tamaños distintos de cero (normalmente unos pocos Kb).
Los dispositivos tienen tamaño cero; por ejemplo, el tamaño de **/dev/sda1** no refleja el tamaño de la partición correspondiente.
Por lo tanto, al usar `min size` y `max size`, es recomendable especificar `types incl` como "*file*" para evitar resultados inesperados.

Ejemplos:

```default
vfs.dir.get[/dev] #recupera la lista de dispositivos en /dev (Linux)
vfs.dir.get["C:\Users\ADMINI~1\AppData\Local\Temp"] #recupera la lista de archivos en un directorio temporal
```

[comment]: # ({/82ed1999-4a354b20})

[comment]: # ({8ac8c233-c1571da2})
##### vfs.dir.size[dir,<regex incl>,<regex excl>,<mode>,<max depth>,<regex excl dir>] {#vfs.dir.size}

<br>
El tamaño del directorio (en bytes).<br>
Valor de retorno: *Integer*.<br>
[Plataformas soportadas](#supported-platforms): Linux, Windows.
El item puede funcionar en otras plataformas tipo UNIX.

Parámetros:

-   **dir** - la ruta absoluta al directorio;
-   **regex incl** - una [expresión regular](/manual/regular_expressions#overview) que describe el patrón de nombre de la entidad (archivo, directorio, enlace simbólico) a incluir; incluye todos si está vacío (valor por defecto);
-   **regex excl** - una [expresión regular](/manual/regular_expressions#overview) que describe el patrón de nombre de la entidad (archivo, directorio, enlace simbólico) a excluir; no excluye ninguno si está vacío (valor por defecto);
-   **mode** - valores posibles: *apparent* (por defecto) - obtiene los tamaños aparentes de los archivos en lugar del uso en disco (actúa como `du -sb dir`), *disk* - obtiene el uso en disco (actúa como `du -s -B1 dir`).
A diferencia del comando `du`, el item vfs.dir.size tiene en cuenta los archivos ocultos al calcular el tamaño del directorio (actúa como `du -sb .[^.]* *` dentro de dir).
-   **max depth** - la profundidad máxima de subdirectorios a recorrer: **-1** (por defecto) - ilimitado, **0** - no desciende a subdirectorios.
-   **regex excl dir** - una [expresión regular](/manual/regular_expressions#overview) que describe el patrón de nombre del directorio a excluir.
Todo el contenido del directorio será excluido (en contraste con `regex excl`)

Comentarios:

-   En Windows, este item sigue rutas UNC, lo que puede ser un [riesgo de seguridad](/manual/best_practices/security/access_control#unc-path-access-on-windows-by-zabbix-agent);
-   Solo se calculan los directorios con al menos permiso de lectura para el usuario *zabbix*.
Para los directorios con solo permiso de lectura, se calcula el tamaño del propio directorio.
Los directorios con permisos de lectura y ejecución se calculan incluyendo el contenido.
-   Con directorios grandes o discos lentos, este item puede agotar el tiempo de espera debido al parámetro Timeout en los archivos de configuración del [agent](/manual/appendix/config/zabbix_agentd) y del [server](/manual/appendix/config/zabbix_server)/[proxy](/manual/appendix/config/zabbix_proxy).
Aumente los valores de timeout según sea necesario.
-   El límite de tamaño de archivo depende del [soporte de archivos grandes](/manual/appendix/items/large_file_support).

Ejemplos:

```default
vfs.dir.size[/tmp,log] #calcula el tamaño de todos los archivos en /tmp que contienen 'log' en sus nombres
vfs.dir.size[/tmp,log,^.+\.old$] #calcula el tamaño de todos los archivos en /tmp que contienen 'log' en sus nombres, excluyendo los archivos con nombres que terminan en '.old'
```

[comment]: # ({/8ac8c233-c1571da2})

[comment]: # ({50995de0-44cb41f6})
##### vfs.file.cksum[file,<mode>] {#vfs.file.cksum}

<br>
La suma de comprobación del archivo, calculada por el algoritmo UNIX cksum.<br>
Valor de retorno: *Entero* - con `mode` como *crc32*, *Cadena* - con `mode` como *md5*, *sha256*.<br>
Consulte las [plataformas soportadas](#supported-platforms).

Parámetros:

-   **file** - la ruta completa al archivo;
-   **mode** - *crc32* (por defecto), *md5* o *sha256*.

Comentarios:

-   En Windows, este item sigue las rutas UNC, lo que puede ser un [riesgo de seguridad](/manual/best_practices/security/access_control#unc-path-access-on-windows-by-zabbix-agent);
-   El límite de tamaño de archivo depende del [soporte de archivos grandes](/manual/appendix/items/large_file_support).

Ejemplo:

```default
vfs.file.cksum[/etc/passwd]
```

Ejemplos de valores devueltos (crc32/md5/sha256 respectivamente):

```default
675436101
9845acf68b73991eb7fd7ee0ded23c44
ae67546e4aac995e5c921042d0cf0f1f7147703aa42bfbfb65404b30f238f2dc
```

[comment]: # ({/50995de0-44cb41f6})

[comment]: # ({c426ad8f-0f4f51a1})
##### vfs.file.contents[file,<encoding>] {#vfs.file.contents}

<br>
Recupera el contenido de un archivo^**[7](#footnotes)**^.<br>
Valor devuelto: *Texto*.<br>
Consulte las [plataformas compatibles](#supported-platforms).

Parámetros:

-   **file** - la ruta completa al archivo;
-   **encoding** - el [identificador](/manual/config/items/itemtypes/zabbix_agent#encoding-settings) de la página de códigos.

Comentarios:

-   En Windows, este item sigue rutas UNC, lo que puede suponer un [riesgo de seguridad](/manual/best_practices/security/access_control#unc-path-access-on-windows-by-zabbix-agent);
-   El valor devuelto está limitado a 16 MB (incluidos los espacios en blanco finales que se truncan); también se aplican los [límites de la base de datos](/manual/config/items/item#text-data-limits);
-   Se devuelve una cadena vacía si el archivo está vacío o contiene solo caracteres LF/CR;
-   La marca de orden de bytes (BOM) se excluye de la salida.

Ejemplo:

```default
vfs.file.contents[/etc/passwd]
```

[comment]: # ({/c426ad8f-0f4f51a1})

[comment]: # ({f808b303-cb77c4fb})
##### vfs.file.exists[file,<types incl>,<types excl>] {#vfs.file.exists}

<br>
Comprueba si el archivo existe.<br>
Valor de retorno: 0 - no encontrado; 1 - existe un archivo del tipo especificado.<br>
Consulte las [plataformas compatibles](#supported-platforms).

Parámetros:

-   **file** - la ruta completa al archivo;
-   **types incl** - la lista de tipos de archivo a incluir, valores posibles: *file* (archivo regular, por defecto (si types\_excl no está definido)), *dir* (directorio), *sym* (enlace simbólico), *sock* (socket), *bdev* (dispositivo de bloque), *cdev* (dispositivo de caracteres), *fifo* (FIFO), *dev* (sinónimo de "bdev,cdev"), *all* (todos los tipos mencionados, por defecto si types\_excl está definido).
-   **types excl** - la lista de tipos de archivo a excluir, consulte types_incl para los valores posibles (por defecto no se excluye ningún tipo)

Comentarios:

-   En Windows, este item sigue rutas UNC, lo que puede ser un [riesgo de seguridad](/manual/best_practices/security/access_control#unc-path-access-on-windows-by-zabbix-agent);
-   Varios tipos deben separarse con una coma y todo el conjunto entre comillas "";
-   Si el mismo tipo está en <types_incl> y <types_excl>, los archivos de este tipo se excluyen;
-   El límite de tamaño de archivo depende del [soporte de archivos grandes](/manual/appendix/items/large_file_support).

Ejemplos:

```default
vfs.file.exists[/tmp/application.pid]
vfs.file.exists[/tmp/application.pid,"file,dir,sym"]
vfs.file.exists[/tmp/application_dir,dir]
```

[comment]: # ({/f808b303-cb77c4fb})

[comment]: # ({d7e06106-12c8307e})
##### vfs.file.get[file] {#vfs.file.get}

<br>
Devuelve información sobre un archivo.<br>
Valor devuelto: *objeto JSON*.<br>
Consulte las [plataformas soportadas](#supported-platforms).

Parámetro:

-   **file** - la ruta completa al archivo

Comentarios:

-   En Windows, este item sigue rutas UNC, lo que puede ser un [riesgo de seguridad](/manual/best_practices/security/access_control#unc-path-access-on-windows-by-zabbix-agent);
-   Tipos de archivos soportados en sistemas tipo UNIX: archivo regular, directorio, enlace simbólico, socket, dispositivo de bloque, dispositivo de caracteres, FIFO.
-   El límite de tamaño de archivo depende del [soporte de archivos grandes](/manual/appendix/items/large_file_support).

Ejemplo:

```default
vfs.file.get[/etc/passwd] #devuelve un JSON con información sobre el archivo /etc/passwd (tipo, usuario, permisos, SID, uid, etc.)
```

[comment]: # ({/d7e06106-12c8307e})

[comment]: # ({ede72ea9-731f3af2})
##### vfs.file.md5sum[file] {#vfs.file.md5sum}

<br>
El checksum MD5 del archivo.<br>
Valor devuelto: Cadena de caracteres (hash MD5 del archivo).<br>
Ver [plataformas soportadas](#supported-platforms).

Parámetro:

-   **file** - la ruta completa al archivo

Comentarios:

-   En Windows, este item sigue rutas UNC, lo que puede ser un [riesgo de seguridad](/manual/best_practices/security/access_control#unc-path-access-on-windows-by-zabbix-agent);
-   El límite de tamaño de archivo depende del [soporte de archivos grandes](/manual/appendix/items/large_file_support).

Ejemplo:

```default
vfs.file.md5sum[/usr/local/etc/zabbix_agentd.conf]
```

Ejemplo de valor devuelto:

```default
b5052decb577e0fffd622d6ddc017e82
```

[comment]: # ({/ede72ea9-731f3af2})

[comment]: # ({995cbe7a-c191e68e})
##### vfs.file.owner[file,<ownertype>,<resulttype>] {#vfs.file.owner}

<br>
Recupera el propietario de un archivo.<br>
Valor devuelto: *Cadena*.<br>
Consulte las [plataformas compatibles](#supported-platforms).

Parámetros:

-   **file** - la ruta completa al archivo;
-   **ownertype** - *user* (por defecto) o *group* (solo Unix);
-   **resulttype** - *name* (por defecto) o *id*; para id - devuelve uid/gid en Unix, SID en Windows.

Comentarios:

-   En Windows, este item sigue rutas UNC, lo que puede ser un [riesgo de seguridad](/manual/best_practices/security/access_control#unc-path-access-on-windows-by-zabbix-agent);
-   El límite de tamaño de archivo depende de la [compatibilidad con archivos grandes](/manual/appendix/items/large_file_support).

Ejemplos:

```default
vfs.file.owner[/tmp/zabbix_server.log] #devuelve el propietario del archivo /tmp/zabbix_server.log
vfs.file.owner[/tmp/zabbix_server.log,,id] #devuelve el ID del propietario del archivo /tmp/zabbix_server.log
```

[comment]: # ({/995cbe7a-c191e68e})

[comment]: # ({630f07da-781f8e91})
##### vfs.file.permissions[file] {#vfs.file.permissions}

<br>
Devuelve una cadena de 4 dígitos que contiene el número octal con los permisos UNIX.<br>
Valor de retorno: *Cadena*.<br>
[Plataformas compatibles](#supported-platforms): Linux.
El elemento puede funcionar en otras plataformas similares a UNIX.

Parámetros:

-   **file** - la ruta completa al archivo

El límite de tamaño de archivo depende de la [compatibilidad con archivos grandes](/manual/appendix/items/large_file_support).

Ejemplo:

```default
vfs.file.permissions[/etc/passwd] #devuelve los permisos de /etc/passwd, por ejemplo, '0644'
```

[comment]: # ({/630f07da-781f8e91})

[comment]: # ({6fb64cef-679ce640})
##### vfs.file.regexp[file,regexp,<encoding>,<start line>,<end line>,<output>] {#vfs.file.regexp}

<br>
Recupera una cadena en el archivo^**[7](#footnotes)**^.<br>
Valor devuelto: La línea que contiene la cadena coincidente, o según lo especificado por el parámetro opcional `output`.<br>
Consulte [plataformas compatibles](#supported-platforms).

Parámetros:

-   **file** - la ruta completa al archivo;
-   **regexp** - una [expresión](/manual/regular_expressions#overview) regular que describe el patrón requerido;
-   **encoding** - el [identificador](/manual/config/items/itemtypes/zabbix_agent#encoding-settings) de la página de códigos;
-   **start line** - el número de la primera línea en la que buscar (la primera línea del archivo por defecto);
-   **end line** - el número de la última línea en la que buscar (la última línea del archivo por defecto);
-   **output** - una plantilla opcional de formato de salida.
La secuencia de escape **\\0** se sustituye por la parte coincidente del texto (desde el primer carácter donde comienza la coincidencia hasta el carácter donde termina) mientras que una secuencia de escape **\\N** (donde N=1...9) se sustituye por el grupo coincidente N-ésimo (o por una cadena vacía si N excede el número de grupos capturados).

Comentarios:

-   En Windows, este item sigue rutas UNC, lo que puede suponer un [riesgo de seguridad](/manual/best_practices/security/access_control#unc-path-access-on-windows-by-zabbix-agent);
-   El límite de tamaño del archivo depende de la [compatibilidad con archivos grandes](/manual/appendix/items/large_file_support).
-   Solo se devuelve la primera línea coincidente;
-   Se devuelve una cadena vacía si ninguna línea coincide con la expresión;
-   La marca de orden de bytes (BOM) se excluye de la salida;
-   La extracción de contenido mediante el parámetro `output` se realiza en el agent.

Ejemplos:

```default
vfs.file.regexp[/etc/passwd,zabbix]
vfs.file.regexp[/path/to/some/file,"([0-9]+)$",,3,5,\1]
vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1] → obtener el ID del usuario *zabbix*
```

[comment]: # ({/6fb64cef-679ce640})

[comment]: # ({3ce8c47b-5216f821})
##### vfs.file.regmatch[file,regexp,<encoding>,<start line>,<end line>] {#vfs.file.regmatch}

<br>
Busca una cadena en el archivo^**[7](#footnotes)**^.<br>
Valores devueltos: 0 - no se encontró coincidencia; 1 - encontrada.<br>
Consulte [plataformas compatibles](#supported-platforms).

Parámetros:

-   **file** - la ruta completa al archivo;
-   **regexp** - una [expresión](/manual/regular_expressions#overview) regular que describe el patrón requerido;
-   **encoding** - el [identificador](/manual/config/items/itemtypes/zabbix_agent#encoding-settings) de la página de códigos;
-   **start line** - el número de la primera línea en la que buscar (la primera línea del archivo por defecto);
-   **end line** - el número de la última línea en la que buscar (la última línea del archivo por defecto).

Comentarios:

-   En Windows, este item sigue rutas UNC, lo que puede suponer un [riesgo de seguridad](/manual/best_practices/security/access_control#unc-path-access-on-windows-by-zabbix-agent);
-   El límite de tamaño del archivo depende de la [compatibilidad con archivos grandes](/manual/appendix/items/large_file_support).
-   La marca de orden de bytes (BOM) se ignora.

Ejemplo:

```default
vfs.file.regmatch[/var/log/app.log,error]
```

[comment]: # ({/3ce8c47b-5216f821})

[comment]: # ({3a0726ba-705b33c8})
##### vfs.file.size[file,<mode>] {#vfs.file.size}

<br>
El tamaño del archivo (en bytes).<br>
Valor devuelto: *Integer*.<br>
Consulte las [plataformas soportadas](#supported-platforms).

Parámetros:

-   **file** - la ruta completa al archivo;
-   **mode** - valores posibles: *bytes* (por defecto) o *lines* (también se cuentan las líneas vacías).

Comentarios:

-   En Windows, este item sigue rutas UNC, lo que puede ser un [riesgo de seguridad](/manual/best_practices/security/access_control#unc-path-access-on-windows-by-zabbix-agent);
-   El archivo debe tener permisos de lectura para el usuario *zabbix*;
-   El límite de tamaño del archivo depende del [soporte de archivos grandes](/manual/appendix/items/large_file_support).

Ejemplo:

```default
vfs.file.size[/var/log/syslog]
```

[comment]: # ({/3a0726ba-705b33c8})

[comment]: # ({24c104b4-d590c33f})
##### vfs.file.time[file,<mode>] {#vfs.file.time}

<br>
La información de tiempo del archivo.<br>
Valor devuelto: *Integer* (timestamp Unix).<br>
Ver [plataformas soportadas](#supported-platforms).

Parámetros:

-   **file** - la ruta completa al archivo;
-   **mode** - valores posibles:<br>*modify* (por defecto) - la última vez que se modificó el contenido del archivo,<br>*access* - la última vez que se leyó el archivo,<br>*change* - la última vez que se cambiaron las propiedades del archivo

Comentarios:

-   En Windows, este item sigue rutas UNC, lo que puede ser un [riesgo de seguridad](/manual/best_practices/security/access_control#unc-path-access-on-windows-by-zabbix-agent);
-   El límite de tamaño de archivo depende del [soporte de archivos grandes](/manual/appendix/items/large_file_support).

Ejemplo:

```default
vfs.file.time[/etc/passwd,modify]
```

[comment]: # ({/24c104b4-d590c33f})

[comment]: # ({96a8d12e-5c6f1f9c})
##### vfs.fs.discovery {#vfs.fs.discovery}

<br>
La lista de sistemas de archivos montados con su tipo y opciones de montaje.
Se utiliza para el descubrimiento de bajo nivel.<br>
Valor de retorno: *objeto JSON*.<br>
[Plataformas soportadas](#supported-platforms): Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows.

[comment]: # ({/96a8d12e-5c6f1f9c})

[comment]: # ({9a40552f-dee74854})
##### vfs.fs.get {#vfs.fs.get}

<br>
La lista de sistemas de archivos montados con su tipo, espacio en disco disponible, estadísticas de inodos y opciones de montaje.
Se puede utilizar para el descubrimiento de bajo nivel.<br>
Valor de retorno: *objeto JSON*.<br>
[Plataformas soportadas](#supported-platforms): Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows.

Comentarios:

-   También se informan los sistemas de archivos con el recuento de inodos igual a cero, lo que puede ser el caso de los sistemas de archivos con inodos dinámicos (por ejemplo, btrfs);
-   Véase también: [Descubrimiento de sistemas de archivos montados](/manual/discovery/low_level_discovery/examples/mounted_filesystems).

[comment]: # ({/9a40552f-dee74854})

[comment]: # ({fdf19acf-c1ad7314})
##### vfs.fs.inode[fs,<modo>] {#vfs.fs.inode}

<br>
El número o porcentaje de inodos.<br>
Valor de retorno: *Entero* - para número; *Flotante* - para porcentaje.<br>
Consulte las [plataformas compatibles](#supported-platforms).

Parámetros:

-   **fs** - el sistema de archivos;
-   **modo** - valores posibles: *total* (por defecto), *free*, *used*, *pfree* (libres, porcentaje), o *pused* (usados, porcentaje).

Si el recuento de inodos es igual a cero, lo que puede ocurrir en sistemas de archivos con inodos dinámicos (por ejemplo, btrfs), los valores de pfree/pused se informarán como "100" y "0" respectivamente.

Ejemplo:

```default
vfs.fs.inode[/,pfree]
```

[comment]: # ({/fdf19acf-c1ad7314})

[comment]: # ({c4232422-2aa216f1})
##### vfs.fs.size[fs,<mode>] {#vfs.fs.size}

<br>
El espacio en disco en bytes o en porcentaje del total.<br>
Valor de retorno: *Entero* - para bytes; *Flotante* - para porcentaje.<br>
Consulte las [plataformas compatibles](#supported-platforms).

Parámetros:

-   **fs**: el sistema de archivos;
-   **mode**: valores posibles: *total* (por defecto), *free*, *used*, *pfree* (libre, porcentaje) o *pused* (usado, porcentaje).

Comentarios:

-   Si el sistema de archivos no está montado, devuelve el tamaño de un sistema de archivos local donde se encuentra el punto de montaje;
-   El espacio reservado de un sistema de archivos se tiene en cuenta y no se incluye cuando se utiliza el modo *free*.

Ejemplo:

```default
vfs.fs.size[/tmp,free]
```

[comment]: # ({/c4232422-2aa216f1})

[comment]: # ({992ae7f8-07413e69})
##### vm.memory.size[<mode>] {#vm.memory.size}

<br>
El tamaño de la memoria en bytes o en porcentaje del total.<br>
Valor de retorno: *Integer* - para bytes; *Float* - para porcentaje.<br>
Consulte las [plataformas soportadas](#supported-platforms).

Parámetro:

-   **mode** - valores posibles: *total* (por defecto), *active*, *anon*, *buffers*, *cached*, *exec*, *file*, *free*, *inactive*, *pinned*, *shared*, *slab*, *wired*, *used*, *pused* (usada, porcentaje), *available* o *pavailable* (disponible, porcentaje).

Comentarios:

-   Este item acepta tres categorías de parámetros:<br>
    - *total* - cantidad total de memoria;
    - tipos de memoria específicos de la plataforma: *active*, *anon*, *buffers*, *cached*, *exec*, *file*, *free*, *inactive*, *pinned*, *shared*, *slab*, *wired*;
    - estimaciones a nivel de usuario sobre cuánta memoria se usa y está disponible: *used*, *pused*, *available*, *pavailable*;
-   El parámetro de modo *active* solo es compatible con FreeBSD, HP-UX, MacOS X, OpenBSD, NetBSD;
-   Los parámetros de modo *anon*, *exec*, *file* solo son compatibles con NetBSD;
-   El parámetro de modo *buffers* solo es compatible con Linux, FreeBSD, OpenBSD, NetBSD;
-   El parámetro de modo *cached* solo es compatible con Linux, FreeBSD, AIX, OpenBSD, NetBSD;
-   Los parámetros de modo *inactive*, *wired* solo son compatibles con FreeBSD, MacOS X, OpenBSD, NetBSD;
-   El parámetro de modo *pinned* solo es compatible con AIX;
-   El parámetro de modo *shared* solo es compatible con Linux 2.4, FreeBSD, OpenBSD, NetBSD;
-   Consulte también [detalles adicionales](/manual/appendix/items/vm.memory.size_params) para este item.

Ejemplo:

```default
vm.memory.size[pavailable]
```

[comment]: # ({/992ae7f8-07413e69})

[comment]: # ({2a3fbd6e-cd3defd2})
##### web.page.get[host,<ruta>,<puerto>] {#web.page.get}

<br>
Obtiene el contenido de una página web.<br>
Valor de retorno: Código fuente de la página web como texto (incluyendo cabeceras).<br>
Consulte las [plataformas soportadas](#supported-platforms).

Parámetros:

-   **host** - el nombre de host o URL (como `scheme://host:port/path`, donde solo *host* es obligatorio).
Esquemas de URL permitidos: *http*, *https*^**[4](#footnotes)**^.
Un esquema ausente se tratará como *http*.
Si se especifica una URL, `ruta` y `puerto` deben estar vacíos.
Especificar nombre de usuario/contraseña al conectarse a servidores que requieren autenticación, por ejemplo: `http://user:password@www.example.com` solo es posible con soporte cURL ^**[4](#footnotes)**^.
[Punycode](https://es.wikipedia.org/wiki/Punycode) es compatible en los nombres de host.
-   **ruta** - la ruta a un documento HTML (por defecto es /);
-   **puerto** - el número de puerto (por defecto es 80 para HTTP)

Comentarios:

-   Este elemento se vuelve no soportado si el recurso especificado en `host` no existe o no está disponible;
-   `host` puede ser un nombre de host, nombre de dominio, dirección IPv4 o IPv6.
Pero para la dirección IPv6 el agente Zabbix debe ser compilado con soporte IPv6 habilitado.

Ejemplos:

```default
web.page.get[www.example.com,index.php,80]
web.page.get[https://www.example.com]
web.page.get[https://blog.example.com/?s=zabbix]
web.page.get[localhost:80]
web.page.get["[::1]/server-status"]
```

[comment]: # ({/2a3fbd6e-cd3defd2})

[comment]: # ({27e5419e-ef902e6e})
##### web.page.perf[host,<ruta>,<puerto>] {#web.page.perf}

<br>
El tiempo de carga de una página web completa (en segundos).<br>
Valor de retorno: *Float*.<br>
Consulte las [plataformas compatibles](#supported-platforms).

Parámetros:

-   **host**: el nombre del host o URL (como `scheme://host:port/path`, donde solo *host* es obligatorio).
Esquemas de URL permitidos: *http*, *https*^**[4](#footnotes)**^.
Un esquema ausente se tratará como *http*.
Si se especifica una URL, `ruta` y `puerto` deben estar vacíos.
Especificar nombre de usuario/contraseña al conectarse a servidores que requieren autenticación, por ejemplo: `http://user:password@www.example.com` solo es posible con soporte cURL ^**[4](#footnotes)**^.
Se admite Punycode en los nombres de host.
-   **ruta**: la ruta a un documento HTML (por defecto es /);
-   **puerto**: el número de puerto (por defecto es 80 para HTTP)

Comentarios:

-   Este elemento se vuelve no compatible si el recurso especificado en `host` no existe o no está disponible;
-   `host` puede ser un nombre de host, nombre de dominio, dirección IPv4 o IPv6.
Pero para la dirección IPv6, el agente Zabbix debe compilarse con soporte IPv6 habilitado.

Ejemplos:

```default
web.page.perf[www.example.com,index.php,80]
web.page.perf[https://www.example.com]
```

[comment]: # ({/27e5419e-ef902e6e})

[comment]: # ({e7d1f328-a78ae078})
##### web.page.regexp[host,<path>,<port>,regexp,<length>,<output>] {#web.page.regexp}

<br>
Busca una cadena en la página web.<br>
Valor devuelto: la cadena coincidente, o según lo especificado por el parámetro opcional `output`.<br>
Consulte las [plataformas compatibles](#supported-platforms).

Parámetros:

-   **host**: el nombre de host o URL (como `scheme://host:port/path`, donde solo *host* es obligatorio).
Los esquemas de URL permitidos son: *http*, *https*^**[4](#footnotes)**^.
Un esquema ausente se tratará como *http*.
Si se especifica una URL, `path` y `port` deben estar vacíos.
Especificar nombre de usuario/contraseña al conectarse a servidores que requieren autenticación, por ejemplo: `http://user:password@www.example.com` solo es posible con soporte cURL ^**[4](#footnotes)**^.
Se admite Punycode en los nombres de host.
-   **path**: la ruta a un documento HTML (por defecto es /);
-   **port**: el número de puerto (por defecto es 80 para HTTP)
-   **regexp**: una [expresión regular](/manual/regular_expressions#overview) que describe el patrón requerido;
-   **length**: el número máximo de caracteres a devolver;
-   **output**: una plantilla de formato de salida opcional.
La secuencia de escape **\\0** se reemplaza por la parte coincidente del texto (desde el primer carácter donde comienza la coincidencia hasta el carácter donde termina la coincidencia), mientras que una secuencia de escape **\\N** (donde N=1...9) se reemplaza por el N-ésimo grupo coincidente (o una cadena vacía si N excede el número de grupos capturados).

Comentarios:

-   Este item pasa a no soportado si el recurso especificado en `host` no existe o no está disponible;
-   `host` puede ser un nombre de host, nombre de dominio, dirección IPv4 o IPv6.
Pero para la dirección IPv6 el agent de Zabbix debe compilarse con soporte IPv6 habilitado.
-   La extracción de contenido usando el parámetro `output` se realiza en el agent.

Ejemplos:

```default
web.page.regexp[www.example.com,index.php,80,OK,2]
web.page.regexp[https://www.example.com,,,OK,2]
```

[comment]: # ({/e7d1f328-a78ae078})

[comment]: # ({634d9a4e-3030d112})

##### agente.hostmetadata {#agente.hostmetadata}

<br>
Los metadatos del host del agente.<br>
Valor de retorno: *Cadena*.<br>
Consulte [plataformas compatibles](#plataformas-compatibles).

Devuelve el valor de los parámetros [HostMetadata](/manual/appendix/config/zabbix_agentd#hostmetadata) o [HostMetadataItem](/manual/appendix/config/zabbix_agentd#hostmetadataitem), o una cadena vacía si no hay ninguno definido.

[comment]: # ({/634d9a4e-3030d112})

[comment]: # ({48e98549-e20fbf57})

##### agente.nombre de host {#agente.nombre de host}

<br>
El nombre de host del agente.<br>
Valor de retorno: *Cadena*.<br>
Consulte [plataformas compatibles](#plataformas-compatibles).

Devoluciones:

- Como verificación pasiva: el nombre del primer host que figura en el parámetro [Hostname](/manual/appendix/config/zabbix_agentd#hostname) del archivo de configuración del agente;
- Como verificación activa: el nombre del host actual.

[comment]: # ({/48e98549-e20fbf57})

[comment]: # ({16f6a0c6-3a10c7e2})

##### agente.ping {#agente.ping}

<br>
La verificación de disponibilidad del agente.<br>
Valor de retorno: Nada - no disponible; 1 - disponible.<br>
Consulte [plataformas compatibles](#plataformas-compatibles).

Utilice la función de activación **nodata()** para comprobar si el host no está disponible.

[comment]: # ({/16f6a0c6-3a10c7e2})

[comment]: # ({f3b2b036-d276be7d})

##### agente.variante {#agente.variante}

<br>
La variante del agente Zabbix (agente Zabbix o agente Zabbix 2).<br>
Valor de retorno: 1 - Agente Zabbix; 2 - Agente Zabbix 2.<br>
Consulte [plataformas compatibles](#plataformas-compatibles).

[comment]: # ({/f3b2b036-d276be7d})

[comment]: # ({77e624b5-f391e3aa})
##### agent.version {#agent.version}

<br>
La versión del agente Zabbix.<br>
Valor de retorno: *Cadena*.<br>
Consulte las [plataformas compatibles](#supported-platforms).

Ejemplo de valor devuelto: 

```default
6.0.3
```

[comment]: # ({/77e624b5-f391e3aa})

[comment]: # ({819350bc-31497288})
##### zabbix.stats[<ip>,<port>] {#zabbix.stats}

<br>
Devuelve un conjunto de métricas internas de Zabbix server o proxy.
Si se especifican `ip` y `port`, las métricas se recuperan de la instancia remota; de lo contrario, de la instancia local.<br>
Valor devuelto: *objeto JSON*.<br>
Consulte [plataformas compatibles](#supported-platforms).

Parámetros:

-   **ip** - la lista de IP/DNS/máscaras de red de servers/proxies que se consultarán de forma remota (el valor predeterminado es 127.0.0.1);
-   **port** - el puerto del server/proxy que se consultará de forma remota (el valor predeterminado es 10051)

Comentarios:

-   Este item devuelve un conjunto seleccionado de métricas internas.
Para más información, consulte [Monitorización remota de estadísticas de Zabbix](/manual/appendix/items/remote_stats#exposed-metrics);
-   Tenga en cuenta que la solicitud de estadísticas solo se aceptará desde las direcciones incluidas en el parámetro 'StatsAllowedIP' del [server](/manual/appendix/config/zabbix_server)/[proxy](/manual/appendix/config/zabbix_proxy) en la instancia de destino.

[comment]: # ({/819350bc-31497288})

[comment]: # ({1e463e1d-ea79fb35})
##### zabbix.stats[<ip>,<port>,queue,<from>,<to>] {#zabbix.stats.two}

<br>
Devuelve el número de items monitorizados en la cola que están retrasados en el server o proxy de Zabbix.
Si se especifican `ip` y `port`, las métricas se recuperan de la instancia remota; de lo contrario, de la instancia local.<br>
Valor devuelto: *objeto JSON*.<br>
Consulte [plataformas compatibles](#supported-platforms).

Parámetros:

-   **ip** - la lista de IP/DNS/máscaras de red de servers/proxies que se consultarán de forma remota (el valor predeterminado es 127.0.0.1);
-   **port** - el puerto del server/proxy que se consultará de forma remota (el valor predeterminado es 10051)
-   **queue** - constante (debe usarse tal cual)
-   **from** - retrasado al menos (el valor predeterminado es 6 segundos)
-   **to** - retrasado como máximo (el valor predeterminado es infinito)

Tenga en cuenta que la solicitud de estadísticas solo se aceptará desde las direcciones incluidas en el parámetro 'StatsAllowedIP' del [server](/manual/appendix/config/zabbix_server)/[proxy](/manual/appendix/config/zabbix_proxy) en la instancia de destino.

[comment]: # ({/1e463e1d-ea79fb35})


  

[comment]: # ({b49a16e9-a2a6198d})
#### Notas al pie

^**1**^Nota específica de Linux.
El agent de Zabbix debe tener acceso de solo lectura al sistema de archivos */proc*.
Los parches del kernel de www.grsecurity.org limitan los derechos de acceso de los usuarios no privilegiados.

^**2**^ `vfs.dev.read[]`, `vfs.dev.write[]`: El agent de Zabbix finalizará las conexiones de dispositivos "obsoletas" si los valores del item no se acceden durante más de 3 horas.
Esto puede ocurrir si un sistema tiene dispositivos con rutas que cambian dinámicamente o si un dispositivo se elimina manualmente.
Tenga en cuenta también que estos items, si utilizan un intervalo de actualización de 3 horas o más, siempre devolverán '0'.

^**3**^ `vfs.dev.read[]`, `vfs.dev.write[]`: Si se utiliza el valor predeterminado *all* para el primer parámetro, la clave devolverá estadísticas resumidas, incluyendo todos los dispositivos de bloque como sda, sdb y sus particiones (sda1, sda2, sdb3...) y múltiples dispositivos (MD raid) basados en esos dispositivos/particiones de bloque y volúmenes lógicos (LVM) basados en esos dispositivos/particiones de bloque.
En tales casos, los valores devueltos deben considerarse solo como valores relativos (dinámicos en el tiempo), pero no como valores absolutos.

^**4**^ SSL (HTTPS) solo es compatible si el agent se compila con soporte para cURL.
De lo contrario, el item pasará a no ser compatible.
  
^**5**^ Los valores `bytes` y `errors` no son compatibles para interfaces de loopback en sistemas Solaris hasta e incluyendo Solaris 10 6/06, ya que las estadísticas de bytes, errores y utilización no son almacenadas y/o reportadas por el kernel.
Sin embargo, si está monitorizando un sistema Solaris a través de net-snmp, se pueden devolver valores ya que net-snmp incluye código heredado de cmu-snmp de 1997 que, al no poder leer los valores de bytes de las estadísticas de la interfaz, devuelve el contador de paquetes (que sí existe en las interfaces de loopback) multiplicado por un valor arbitrario de 308.
Esto supone que la longitud media de un paquete es de 308 octetos, lo cual es una estimación muy aproximada, ya que el límite de MTU en sistemas Solaris para interfaces de loopback es de 8892 bytes.
No se debe suponer que estos valores sean correctos o siquiera cercanos a la realidad.
Son estimaciones.
El agent de Zabbix no realiza ninguna suposición, pero net-snmp devolverá un valor para estos campos.

^**6**^ La línea de comandos en Solaris, obtenida de /proc/pid/psinfo, está limitada a 80 bytes y contiene la línea de comandos tal como estaba cuando se inició el proceso.

^**7**^ Los items `vfs.file.contents[]`, `vfs.file.regexp[]`, `vfs.file.regmatch[]` pueden usarse para recuperar el contenido de archivos.
Si desea restringir el acceso a archivos específicos con información confidencial, ejecute el agent de Zabbix bajo un usuario que no tenga permisos de acceso para ver estos archivos.

[comment]: # ({/b49a16e9-a2a6198d})

[comment]: # ({bc60d97c-2e3a2e64})
### Uso con utilidades de línea de comandos

Tenga en cuenta que al probar o utilizar claves de ítem con zabbix_agentd o zabbix_get desde la línea de comandos también debe considerar la sintaxis de la shell.

Por ejemplo, si un determinado parámetro de la clave debe ir entre comillas dobles, debe escapar explícitamente las comillas dobles; de lo contrario, la shell las eliminará como caracteres especiales y no se pasarán a la utilidad de Zabbix.

Ejemplos:

```default
zabbix_agentd -t 'vfs.dir.count[/var/log,,,"file,dir",,0]'

zabbix_agentd -t vfs.dir.count[/var/log,,,\"file,dir\",,0]
```

[comment]: # ({/bc60d97c-2e3a2e64})

[comment]: # ({b6df4604-b7e5172f})
### Configuración de codificación

Para asegurarse de que los datos adquiridos no se corrompan, puede especificar la codificación correcta para procesar la comprobación (por ejemplo, 'vfs.file.contents') en el parámetro `encoding`.
La lista de codificaciones soportadas (identificadores de página de códigos) puede encontrarse en la documentación de [libiconv](http://www.gnu.org/software/libiconv/) (Proyecto GNU) o en la documentación de Microsoft Windows SDK para ["Identificadores de página de códigos"](https://learn.microsoft.com/en-us/windows/win32/intl/code-page-identifiers).
Tenga en cuenta que Microsoft a veces marca algunas páginas de códigos como "disponibles sólo para aplicaciones administradas", es decir, expuestas sólo a través del entorno de ejecución .NET y no disponibles a través de las API nativas de Win32. El agent de Zabbix implementa su propia lógica de conversión de codificación, por lo tanto, esas páginas de códigos son soportadas por el agent de Zabbix incluso cuando las funciones nativas de Windows no las proporcionan.

Si no se especifica ninguna codificación en el parámetro `encoding`, se aplican las siguientes estrategias de resolución:

-   Si no se especifica la codificación (o es una cadena vacía), se asume que es UTF-8, los datos se procesan "tal cual";
-   Análisis de BOM - aplicable para los items 'vfs.file.contents', 'vfs.file.regexp', 'vfs.file.regmatch'.
Se intenta determinar la codificación correcta utilizando la marca de orden de bytes (BOM) al principio del archivo.
Si no está presente el BOM, se aplica la resolución estándar (ver arriba).

[comment]: # ({/b6df4604-b7e5172f})

[comment]: # ({4f4d51c0-40450e88})
### Solución de problemas de elementos del agente

En el caso de comprobaciones pasivas, para evitar que un elemento no obtenga ningún valor porque la solicitud del servidor al agente se agota primero, se debe tener en cuenta lo siguiente:

-   Cuando la versión del agente es anterior a la versión del servidor, el valor de *Timeout* en la [configuración del elemento](/manual/config/items/item#configuration) (o [timeout global](/manual/web_interface/frontend_sections/administration/general#timeouts)) puede necesitar ser mayor que el valor de `Timeout` en el [archivo de configuración](/manual/appendix/config/zabbix_agentd#timeout) del agente.
-   Cuando la versión del agente es más reciente que la versión del servidor, el valor de `Timeout` en el [archivo de configuración](/manual/appendix/config/zabbix_server#timeout) del servidor puede necesitar ser mayor que el valor de `Timeout` en el [archivo de configuración](/manual/appendix/config/zabbix_agentd#timeout) del agente.

[comment]: # ({/4f4d51c0-40450e88})