# Splunk

Splunk es una plataforma de software que ayuda a las organizaciones a buscar, monitorear y analizar datos de diversas fuentes de terceros. Verkada permite a los usuarios crear flujos de trabajo eficientes para enviar información de sus organizaciones en Command a sus instancias de Splunk mediante una integración incorporada.

Cuando integras Verkada con Splunk, te permite centralizar y analizar tus datos de videoseguridad dentro del contexto más amplio de tus datos operativos, lo que posibilita mejores conocimientos y toma de decisiones. Puedes usar esta implementación para importar los conteos de personas y vehículos de todas las cámaras de tu organización, incluidas las notificaciones de dispositivos.

{% hint style="danger" %}
Antes de comenzar, debes tener:

* Una instancia activa de Splunk con acceso de administrador. Obtén más información sobre [Roles y permisos para Command](https://help.verkada.com/command/es/usuarios-y-permisos/roles-and-permissions-for-command).
* Permisos de Administrador de organización en tu organización de Verkada.
* Una clave de API de Verkada válida. Aprende cómo [generar una clave de API de Verkada](https://apidocs.verkada.com/reference/quick-start-guide)
  {% endhint %}

Hay 2 formas en las que puedes configurar la integración:

* [Descargar e instalar el software Splunk Enterprise](#h_c45403a4de)
* [Descargar e instalar el software en Splunkbase](#h_7b8e057156)

***

## Descargar e instalar el software Splunk Enterprise

{% stepper %}
{% step %}
**Descarga el software Splunk Enterprise en** [**https://www.splunk.com/en\_us/download.html**](https://www.splunk.com/en_us/download.html)**. Si ya tienes una cuenta de Splunk Enterprise instalada y configurada, continúa con el paso 4.**

<div align="left" data-with-frame="true"><img src="https://2387489060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-27d568b9437f786dd81fc41ad22bea7895a12744%2Fb0b4d671eb8b15a22dd70cc0f7863e480d1f0580.png?alt=media" alt="" width="800"></div>
{% endstep %}

{% step %}
**Selecciona el paquete de instalación correspondiente, según el sistema operativo que estés usando (Windows, Linux o MacOS). Recomendamos descargar el paquete .dmg para un proceso de configuración más sencillo.**

<div align="left" data-with-frame="true"><img src="https://2387489060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-a8a0fafb73a04bdf350276b960fafb205d918acc%2F1332cff65c0be9eba2d4b1afc8f5bd9495023ade.png?alt=media" alt="" width="800"></div>
{% endstep %}

{% step %}
**Una vez que el paquete Splunk Enterprise esté instalado, abre la aplicación. Deberías ser redirigido a una ventana de Terminal o PowerShell donde podrás crear las credenciales de tu cuenta (nombre de usuario y contraseña).**

​\
​**Importante**: Conserva estas credenciales. Las necesitarás (más adelante) para iniciar sesión en Splunk y configurar la integración de Verkada. Una vez que crees tu cuenta, deberías recibir un correo electrónico para verificarla. Asegúrate de revisar tu bandeja de entrada y completar este paso antes de continuar con el proceso de configuración.
{% endstep %}

{% step %}
**La aplicación Splunk debería abrirse automáticamente después de establecer tu nombre de usuario y contraseña. Inicia sesión usando las credenciales que configuraste en el paso 3. Si la ventana de Splunk Enterprise no se abre, navega a la siguiente URL para iniciar sesión:**

​\
<http://localhost:8000/en-US/account/login?return\\_to=%2Fen-US%2Fapp%2Flauncher%2Fhome>

<div align="left" data-with-frame="true"><img src="https://2387489060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-25f10b811ace459ea235723852a4709fd7601bf4%2F6a827e1ea61b8352384bf954cdf23d69c86d75ea.png?alt=media" alt="" width="753"></div>

La página de inicio de Splunk es donde se administran y configuran todas tus aplicaciones para varias integraciones, incluida Verkada.
{% endstep %}

{% step %}
**En la parte superior izquierda, haz clic en el desplegable Apps y selecciona Find more apps.**

<div align="left" data-with-frame="true"><img src="https://2387489060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-a2a955feb0d1f518d69609c58de05c1398472852%2F4511f6dcd993eeee3fc6a7b836d8590af21cb938.png?alt=media" alt="" width="800"></div>
{% endstep %}

{% step %}
**En Browse More Apps:**

a. En el cuadro de búsqueda, ingresa **Verkada**. Esto devuelve 2 aplicaciones.\
b. Instala la aplicación de Verkada que haya sido actualizada más recientemente (**verkada add-on**).\
c. Haz clic **Install** para la aplicación Verkada.

<div align="left" data-with-frame="true"><img src="https://2387489060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-e9daf86c9bf313b8d98c366f862a1238e94c44b1%2Ff586f12f53d86fa8ada1454a8717eb01ac06ca51.png?alt=media" alt="" width="800"></div>
{% endstep %}

{% step %}
**En Login and Install:**

a. Ingresa las credenciales de tu cuenta de Splunk para verificar tu cuenta.\
​\
​**Nota:** Estas credenciales son diferentes de las creadas en el paso 3. Para instalar la aplicación, utiliza el correo electrónico y la contraseña usados para iniciar sesión en tu cuenta general de Splunk. (<https://www.splunk.com/>).\
​\
b. Haz clic **Agree and Install**.\
​

<div align="left" data-with-frame="true"><img src="https://2387489060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-5e914ca4534f8cbb5a0270547c8852a5a03b7373%2F201110dae6331d0259dc1c9aae599f263c9f7ec0.png?alt=media" alt="" width="573"></div>
{% endstep %}
{% endstepper %}

***

## Descargar e instalar el software en Splunkbase

Si el [método de instalación anterior](#h_c45403a4de) no funciona, existe una forma alternativa descrita aquí.

{% stepper %}
{% step %}
**Descarga la aplicación en** [**https://splunkbase.splunk.com/app/6971**](https://splunkbase.splunk.com/app/6971)**.**
{% endstep %}

{% step %}
**Haz clic en Download para descargar la aplicación complementaria de Verkada.**

<div align="left" data-with-frame="true"><img src="https://2387489060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-cf73a5dd37605a85261072d98e2dba10be60318f%2F4a0ade8e13e3cdc253ccebfecf00651d5c6743bd.png?alt=media" alt="" width="800"></div>
{% endstep %}

{% step %}
**Cuando se haya descargado el paquete:**

a. Regresa a tu cuenta de Splunk Enterprise.\
b. Bajo el **Apps** desplegable, selecciona **Manage Apps**.
{% endstep %}

{% step %}
**En Manage Apps, en la parte superior derecha, haz clic en Install app from file.**

<div align="left" data-with-frame="true"><img src="https://2387489060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-ac39d3dc4e6fb98f253be51203e8070cb708d7ac%2F796ba9a06c3d8a1af6bd5ef796afe5eb1b0ba159.png?alt=media" alt="" width="1727"></div>
{% endstep %}

{% step %}
**Serás redirigido a una nueva página que te pedirá que elijas el archivo de instalación de la aplicación que quieres agregar a tu instancia de Splunk.**
{% endstep %}

{% step %}
**En Install App From File:**

a. Haz clic en **Choose File**.\
b. En tu carpeta **Downloads** , encuentra el archivo descargado recientemente (**verkada-add-on\_126.tgz**).\
c. Selecciona el archivo y haz clic en **Upload**.

<div align="left" data-with-frame="true"><img src="https://2387489060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-4cd1805940530f86c3019c306ab1a1d71fa017ed%2F365b5eb4aaade37f2b3b0debd1f9a6e03d970535.png?alt=media" alt="" width="691"></div>
{% endstep %}

{% step %}
**Una vez que la aplicación esté descargada, bajo Apps, deberías ver la pestaña Verkada Add-On en tu página de inicio.**

<div align="left" data-with-frame="true"><img src="https://2387489060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-cd1e53e6da4deab95044e21bf4512aa1f1c51a88%2F86518f6e1eb46ddfd600a34d9a33684c64396e4e.png?alt=media" alt="" width="800"></div>
{% endstep %}

{% step %}
**Haz clic en la pestaña Verkada Add-On. Esto te redirige a una nueva página donde puedes configurar y administrar tu integración de Verkada.**

<div align="left" data-with-frame="true"><img src="https://2387489060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-c451d5e6b4183e9c2759a85c993f5c3c4d25f269%2F8fbbaa95e1d7a5f330c6b0ac91e875cc2f2c246f.png?alt=media" alt="" width="1728"></div>
{% endstep %}

{% step %}
**En la página de tu aplicación Verkada, en la parte superior derecha, haz clic en Add Input. Esto te permite crear 2 tipos diferentes de entradas:**

* **verkada\_insights** proporciona la información de detección de objetos para cada cámara en tu organización. En intervalos programados regularmente, muestra el conteo tanto de personas como de vehículos detectados y la marca de tiempo asociada a esos conteos.
* **verkada\_notifications** proporciona la lista completa de todas las notificaciones generadas por tus dispositivos Verkada.
  {% endstep %}

{% step %}
**Dependiendo de tu caso de uso con la integración de Verkada en Splunk, crea una nueva entrada para verkada\_insights, verkada\_notifications, o ambas.**

​**Nota**: Para generar resultados para ambas opciones, necesitas crear 2 entradas separadas para cada función.\
​
{% endstep %}

{% step %}
**Una vez que hayas seleccionado tu entrada, se te solicitará que ingreses los siguientes ajustes:**

a. Nombre único para tu entrada de datos\
b. Intervalo de tiempo (en segundos) para cada entrada procesada\
c. Índice (recomendado **predeterminado**)\
d. El ID de organización de tu Verkada Command\
e. Tu [clave de API de Verkada](https://apidocs.verkada.com/reference/quick-start-guide).\
f. Haz clic en **Add**.

<div align="left" data-with-frame="true"><img src="https://2387489060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-273f3f881a7cc9530da89611c1ce48a6ef9ef118%2Ff3b3951443c4709c218dee96417c4f56c99ac19e.png?alt=media" alt="" width="805"></div>
{% endstep %}

{% step %}
**Una vez que hayas agregado esta nueva entrada de datos, puedes verla bajo la pestaña Input de la aplicación Verkada, con el nombre correspondiente que creaste en el paso 11.**

<div align="left" data-with-frame="true"><img src="https://2387489060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-933a6a1f0dc4c531924b5758835fc653636ff332%2Fa49a0ae9705ad9c458bc086c1c0ac49f76bf5406.png?alt=media" alt="" width="800"></div>
{% endstep %}

{% step %}
**Verifica que la integración sea exitosa:**

a. Ve a la pestaña **Search** .\
b. Ingresa **source="verkada\_insights"** o **source="verkada\_notifications"**, dependiendo de la entrada de datos que configuraste.

<div align="left" data-with-frame="true"><img src="https://2387489060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-be46f81429938ca747b9b54df00a358003890fdb%2F4d963af334d0dd2230567c12adc08fa741a2ae5f.png?alt=media" alt="" width="800"></div>

<div align="left" data-with-frame="true"><img src="https://2387489060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-08ae67312b2787873b3d656e87e9e6dbaee39feb%2F0df48c46ff77364eada3fd42d2f17e97dc94d72e.png?alt=media" alt="" width="800"></div>

<div align="left" data-with-frame="true"><img src="https://2387489060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-4755d90bf95767de61439bc9ccc3126ee6333994%2F1b5267abd0f312705a161c525bd061014efb782a.png?alt=media" alt="" width="1726"></div>
{% endstep %}
{% endstepper %}

***

## Solución de problemas

Al actualizar de la versión 1.1.0 a la versión 1.2.6, puede que haya algunas entradas nuevas que no aparezcan de inmediato. Si este es el caso, sigue los pasos a continuación para resolver el problema:

* Reinicia tu instancia de Splunk e inicia sesión nuevamente en tu cuenta.
* Si las 3 entradas aún no aparecen, elimina y reinstala la aplicación Verkada Add-On:
  1. Navega al directorio de aplicaciones de tu Splunk.
  2. Elimina la carpeta `SPLUNK_HOME/etc/apps/TA-verkada-add-on`.

     **Nota:** Es posible que necesites reiniciar tu instancia de Splunk para que el cambio surta efecto.
  3. Vuelve al paso 1 de esta guía de instalación para descargar la aplicación Verkada Add-On desde Splunk.
  4. Ahora deberías ver las nuevas entradas en la aplicación Verkada.

Puede haber otros problemas comunes que podrían provocar errores en la extracción de datos:

* Clave de API de Verkada caducada.
* ID de organización de Command incorrecto

Para una vista más detallada y comprensión de los problemas de integración en curso, los usuarios pueden acceder a los registros completos de Splunk ubicados en `SPLUNK_HOME/var/log/splunk`. Puedes ajustar el nivel de registro en la pestaña de configuración del complemento.