# Splunk

Splunk est une plateforme logicielle qui aide les organisations à rechercher, surveiller et analyser des données provenant de diverses sources tierces. Verkada permet aux utilisateurs de mettre en place des workflows efficaces pour transférer des informations de leurs organisations Command vers leurs instances Splunk grâce à une intégration intégrée.

Lorsque vous intégrez Verkada à Splunk, cela vous permet de centraliser et d’analyser vos données de vidéosurveillance dans le contexte plus large de vos données opérationnelles, ce qui facilite une meilleure compréhension et une meilleure prise de décision. Vous pouvez utiliser cette implémentation pour importer les comptages de personnes et de véhicules sur l’ensemble des caméras de votre organisation, y compris les notifications des appareils.

{% hint style="danger" %}
Avant de commencer, vous devez disposer de :

* Une instance Splunk active avec accès administrateur. En savoir plus sur [les rôles et autorisations pour Command](/command/fr/utilisateurs-et-autorisations/roles-and-permissions-for-command.md).
* des autorisations d’administrateur d’organisation pour votre organisation Verkada.
* Une clé API Verkada valide. Découvrez comment [générer une clé API Verkada](https://apidocs.verkada.com/reference/quick-start-guide)
  {% endhint %}

Il existe 2 façons de configurer l’intégration :

* [Télécharger et installer le logiciel Splunk Enterprise](#h_c45403a4de)
* [Télécharger et installer le logiciel depuis Splunkbase](#h_7b8e057156)

***

## Télécharger et installer le logiciel Splunk Enterprise

{% stepper %}
{% step %}
**Téléchargez le logiciel Splunk Enterprise sur** [**https://www.splunk.com/en\_us/download.html**](https://www.splunk.com/en_us/download.html)**. Si vous disposez déjà d’un compte Splunk Enterprise installé et configuré, passez à l’étape 4.**

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

{% step %}
**Sélectionnez le package d’installation correspondant, selon le système d’exploitation que vous utilisez (Windows, Linux ou MacOS). Nous recommandons de télécharger le package .dmg pour un processus de configuration plus simple.**

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

{% step %}
**Une fois le package Splunk Enterprise installé, ouvrez l’application. Vous devriez être redirigé vers une fenêtre Terminal ou PowerShell où vous pourrez créer vos identifiants de compte (nom d’utilisateur et mot de passe).**

​\
​**Important**: Conservez ces identifiants. Vous en aurez besoin (plus tard) pour vous connecter à Splunk et configurer l’intégration Verkada. Une fois votre compte créé, vous devriez recevoir un e-mail pour vérifier votre compte. Veillez à consulter votre boîte de réception et à terminer cette étape avant de poursuivre le processus de configuration.
{% endstep %}

{% step %}
**L’application Splunk devrait s’ouvrir automatiquement après la définition de votre nom d’utilisateur et de votre mot de passe. Connectez-vous à l’aide des identifiants configurés à l’étape 3. Si la fenêtre Splunk Enterprise ne s’ouvre pas, accédez à l’URL suivante pour vous connecter :**

​\ <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/293bfcb1e9b8c37bcdf2bc6b9a053c4a5b408850" alt="" width="753"></div>

La page d’accueil de Splunk est l’endroit où sont gérées et configurées toutes vos applications pour diverses intégrations, y compris Verkada.
{% endstep %}

{% step %}
**En haut à gauche, cliquez sur le menu déroulant Apps et sélectionnez Find more apps.**

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

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

a. Dans la zone de recherche, saisissez **Verkada**. Cela renvoie 2 applications.\
b. Installez l’application Verkada qui a été mise à jour le plus récemment (**verkada add-on**).\
c. Cliquez sur **Install** pour l’application Verkada.

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

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

1. Saisissez les identifiants de votre compte Splunk pour vérifier votre compte.

{% hint style="info" %}
Ces identifiants sont différents de ceux créés à l’étape 3. Pour installer l’application, utilisez l’e-mail et le mot de passe utilisés pour vous connecter à votre compte Splunk général. (<https://www.splunk.com/>).
{% endhint %}

2. Cliquez sur **Agree and Install**.
   {% endstep %}
   {% endstepper %}

***

## Télécharger et installer le logiciel depuis Splunkbase

Si la [méthode d’installation ci-dessus](#h_c45403a4de) ne fonctionne pas, une autre méthode est décrite ici.

{% stepper %}
{% step %}
**Téléchargez l’application sur** [**https://splunkbase.splunk.com/app/6971**](https://splunkbase.splunk.com/app/6971)**.**
{% endstep %}

{% step %}
**Cliquez sur Download pour télécharger l’application add-on Verkada.**

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

{% step %}
**Une fois le package téléchargé :**

a. Retournez sur votre compte Splunk Enterprise.\
b. Sous **Apps** , sélectionnez **Manage Apps**.
{% endstep %}

{% step %}
**Dans Manage Apps, en haut à droite, cliquez sur Install app from file.**

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

{% step %}
**Vous êtes alors redirigé vers une nouvelle page qui vous invite à choisir le fichier d’installation de l’application que vous souhaitez ajouter à votre instance Splunk.**
{% endstep %}

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

a. Cliquez sur **Choose File**.\
b. Dans votre **Downloads** , recherchez le fichier récemment téléchargé (**verkada-add-on\_126.tgz**).\
c. Sélectionnez le fichier et cliquez sur **Upload**.

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

{% step %}
**Une fois l’application téléchargée, sous Apps, vous devriez voir l’onglet Verkada Add-On sur votre page d’accueil.**

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

{% step %}
**Cliquez sur l’onglet Verkada Add-On. Cela vous redirige vers une nouvelle page où vous pouvez configurer et gérer votre intégration Verkada.**

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

{% step %}
**Sur la page de votre application Verkada, en haut à droite, cliquez sur Add Input. Cela vous permet de créer 2 types d’entrées différents :**

* **verkada\_insights** fournit les informations de détection d’objets pour chaque caméra de votre organisation. À intervalles réguliers programmés, il affiche le nombre de personnes et de véhicules détectés, ainsi que l’horodatage associé à ces comptages.
* **verkada\_notifications** fournit la liste complète de toutes les notifications générées par vos appareils Verkada.
  {% endstep %}

{% step %}
**Selon votre cas d’usage avec l’intégration Splunk de Verkada, créez une nouvelle entrée pour verkada\_insights, verkada\_notifications, ou les deux.**

{% hint style="warning" %}
​Pour générer des résultats pour les deux options, vous devez créer 2 entrées distinctes pour chaque fonctionnalité.\
​
{% endhint %}
{% endstep %}

{% step %}
**Une fois votre entrée sélectionnée, vous êtes invité à saisir les paramètres suivants :**

a. Nom unique pour votre entrée de données\
b. Intervalle de temps (en secondes) pour chaque entrée traitée\
c. Index (recommandé **par défaut**)\
d. L’identifiant de votre organisation Verkada Command\
e. Votre [clé API Verkada](https://apidocs.verkada.com/reference/quick-start-guide).\
f. Cliquez sur **Add**.
{% endstep %}

{% step %}
**Une fois cette nouvelle entrée de données ajoutée, vous pouvez la voir dans l’onglet Input de l’application Verkada, avec le nom correspondant que vous avez créé à l’étape 11.**

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

{% step %}
**Vérifiez que l’intégration a réussi :**

a. Allez dans l’onglet **Search** .\
b. Saisissez **source="verkada\_insights"** ou **source="verkada\_notifications"**, selon l’entrée de données que vous avez configurée.

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

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

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

***

## Dépannage

Lors de la mise à niveau de la version 1.1.0 vers la version 1.2.6, il se peut que certaines nouvelles entrées n’apparaissent pas immédiatement. Si c’est le cas, veuillez suivre les étapes ci-dessous pour résoudre le problème :

* Redémarrez votre instance Splunk et reconnectez-vous à votre compte.
* Si les 3 entrées ne s’affichent toujours pas, supprimez et réinstallez l’application Verkada Add-On :
  1. Accédez au répertoire de votre application Splunk.
  2. Supprimez le dossier `SPLUNK_HOME/etc/apps/TA-verkada-add-on`.

{% hint style="info" %}
Vous devrez peut-être redémarrer votre instance Splunk pour que le changement prenne effet.
{% endhint %}

3. Revenez à l’étape 1 de ce guide de configuration pour télécharger l’application Verkada Add-On depuis Splunk.
4. Vous devriez maintenant voir les nouvelles entrées sous l’application Verkada.

Il peut exister d’autres problèmes courants pouvant entraîner des erreurs lors de la récupération des données :

* Clé API Verkada expirée.
* ID d’organisation Command incorrect

Pour une vue plus détaillée et une meilleure compréhension des problèmes d’intégration en cours, les utilisateurs peuvent accéder aux journaux Splunk complets situés dans `SPLUNK_HOME/var/log/splunk`. Vous pouvez ajuster le niveau de journalisation dans l’onglet de configuration de l’add-on.


---

# 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/fr/parametres-de-lorganisation/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.