# Splunk

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

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 permite obtener mejores conocimientos y tomar decisiones. Puedes usar esta implementación para incorporar conteos de personas y vehículos en 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](/command/es/usuarios-y-permisos/roles-and-permissions-for-command.md).
* Permisos de administrador de la organización para tu organización de Verkada.
* Una clave API válida de Verkada. Aprende cómo [generar una clave API de Verkada](https://apidocs.verkada.com/reference/quick-start-guide)
  {% endhint %}

Hay 2 formas de configurar la integración:

* [Descarga e instala el software Splunk Enterprise](#h_c45403a4de)
* [Descarga e instala el software en Splunkbase](#h_7b8e057156)

***

## Descarga e instala 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="/files/3c85999ada558be4e918e0f8b5ef0112a40a403d" 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="/files/5c124ed85fc9c979ec386c55985cdb100ecdd3b7" alt="" width="800"></div>
{% endstep %}

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

​\
​**Importante**: Guarda 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 verificar tu cuenta. 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 de 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:**

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

<div align="left" data-with-frame="true"><img src="/files/a9c07bf4659cfaa18a70e29936c4b0d57ca84eb2" alt="" width="753"></div>

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

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

<div align="left" data-with-frame="true"><img src="/files/3d67519a17e8465384643a4c6432bb6811c0beb8" 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 se haya actualizado más recientemente (**verkada add-on**).\
c. Haz clic en **Install** para la aplicación de Verkada.

<div align="left" data-with-frame="true"><img src="/files/c48f86f5fe6693754cefc378802f8922779964fc" alt="" width="800"></div>
{% endstep %}

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

1. Introduce las credenciales de tu cuenta de Splunk para verificar tu cuenta.

{% hint style="info" %}
Estas credenciales son diferentes de las creadas en el paso 3. Para instalar la aplicación, usa el correo electrónico y la contraseña que usas para iniciar sesión en tu cuenta general de Splunk. (<https://www.splunk.com/>).
{% endhint %}

2. Haga clic en **Agree and Install**.
   {% endstep %}
   {% endstepper %}

***

## Descarga e instala el software en Splunkbase

Si el [método de instalación anterior](#h_c45403a4de) no funciona, hay 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 complemento de Verkada.**

<div align="left" data-with-frame="true"><img src="/files/639759584cf50a83145f8d3e4dd7ce8113ab7ead" alt="" width="800"></div>
{% endstep %}

{% step %}
**Cuando se descarga el paquete:**

a. Vuelve a tu cuenta de Splunk Enterprise.\
b. En **Apps** seleccione **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="/files/a395062f8441747a0ddc6f538a7b0e46a4f36bee" alt="" width="1727"></div>
{% endstep %}

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

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

a. Haga clic en **Choose File**.\
b. En tu carpeta de **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="/files/d9397c57a7cfc14203ede2a78bafa78a7f15c05b" alt="" width="691"></div>
{% endstep %}

{% step %}
**Una vez descargada la aplicación, en 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="/files/c82cb2df5fc09d923f4c7f161ab37d0d2820cd75" 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="/files/5be625734626ed28b0887e5ad18aa5d39d703285" alt="" width="1728"></div>
{% endstep %}

{% step %}
**En la página de tu aplicación de 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 de tu organización. A intervalos programados regularmente, muestra el conteo de personas y 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 %}
**Según tu caso de uso con la integración de Splunk de Verkada, crea una nueva entrada para verkada\_insights, verkada\_notifications o ambas.**

{% hint style="warning" %}
​Para generar resultados para ambas opciones, necesitas crear 2 entradas separadas para cada función.\
​
{% endhint %}
{% endstep %}

{% step %}
**Una vez que hayas seleccionado tu entrada, se te pedirá que ingreses la siguiente configuración:**

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 API de Verkada](https://apidocs.verkada.com/reference/quick-start-guide).\
f. Haz clic en **Add**.
{% endstep %}

{% step %}
**Una vez que hayas agregado esta nueva entrada de datos, puedes verla en 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="/files/e6135f9f4d19ad83f6585e67cdd8f485e6050b89" 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"**, según la entrada de datos que configuraste.

<div align="left" data-with-frame="true"><img src="/files/2443111047663789b81c7936a62a3ddc82723ea6" alt=""></div>

<div align="left" data-with-frame="true"><img src="/files/6746b5d2c7937511dd5f3e7effba4dc9fc912c07" alt=""></div>

<div align="left" data-with-frame="true"><img src="/files/c2d5bdd4d64936b4341dada2faff640a675923e2" alt=""></div>
{% endstep %}
{% endstepper %}

***

## Resolución de problemas

Al actualizar de la versión 1.1.0 a la versión 1.2.6, puede haber 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 y vuelve a iniciar sesión en tu cuenta.
* Si las 3 entradas aún no aparecen, elimina y reinstala la aplicación Verkada Add-On:
  1. Navega hasta tu directorio de la aplicación de Splunk.
  2. Elimina la carpeta `SPLUNK_HOME/etc/apps/TA-verkada-add-on`.

{% hint style="info" %}
Es posible que necesites reiniciar tu instancia de Splunk para que el cambio surta efecto.
{% endhint %}

3. Vuelve al paso 1 de esta guía de configuración para descargar la aplicación Verkada Add-On desde Splunk.
4. Ahora deberías ver las nuevas entradas en la aplicación de Verkada.

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

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

Para una vista y comprensión más detalladas 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.verkada.com/command/es/configuracion-de-la-organizacion/integrations/verkada-splunk-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
