# Splunk

Splunkは、組織がさまざまなサードパーティソースからデータを検索、モニター、分析するのに役立つソフトウェアプラットフォームです。Verkadaを使用すると、ユーザーは効率的なワークフローを構築し、組み込みの統合機能を通じてCommandのオーガナイゼーション'からSplunkインスタンスへ情報を送信できます。

VerkadaをSplunkと統合すると、ビデオ監視データを運用データのより広い文脈の中で一元化・分析できるようになり、より良いインサイトと意思決定が可能になります。この実装を使用して、デバイス通知を含む、組織内のすべてのカメラにわたる人数カウントと車両カウントを取り込むことができます。

{% hint style="danger" %}
始める前に、以下が必要です：

* Adminアクセス権のある有効なSplunkインスタンス。詳細はこちら： [Commandのロールと権限](/command/ja/yzto/roles-and-permissions-for-command.md).
* Verkadaオーガナイゼーション'に対するOrg Admin権限。
* 有効なVerkada APIキー。取得方法はこちら： [Verkada APIキーを生成する](https://apidocs.verkada.com/reference/quick-start-guide)
  {% endhint %}

統合を設定する方法は2つあります：

* [Splunk Enterpriseソフトウェアをダウンロードしてインストールする](#h_c45403a4de)
* [Splunkbaseでソフトウェアをダウンロードしてインストールする](#h_7b8e057156)

***

## Splunk Enterpriseソフトウェアをダウンロードしてインストールする

{% stepper %}
{% step %}
**Splunk Enterpriseソフトウェアを次からダウンロードしてください：** [**https://www.splunk.com/en\_us/download.html**](https://www.splunk.com/en_us/download.html)**。すでにSplunk Enterpriseアカウントをインストールして設定済みの場合は、手順4に進んでください。**

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

{% step %}
**使用しているオペレーティングシステム（Windows、Linux、またはMacOS）に応じた対応するインストールパッケージを選択してください。より簡単に設定するために、.dmgパッケージのダウンロードを推奨します。**

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

{% step %}
**Splunk Enterpriseパッケージのインストールが完了したら、アプリケーションを開きます。アカウント認証情報（ユーザー名とパスワード）を作成するために、ターミナルまたはPowerShellウィンドウにリダイレクトされるはずです。**

​\
​**重要**: この認証情報は保管してください。後でSplunkにログインしてVerkada統合を設定する際に必要です。アカウントを作成すると、アカウントを確認するためのメールが届くはずです。受信トレイを確認し、設定を進める前にこの手順を完了してください。
{% endstep %}

{% step %}
**ユーザー名とパスワードを設定すると、Splunkアプリケーションは自動的に開くはずです。手順3で設定した認証情報を使用してログインしてください。Splunk Enterpriseウィンドウが開かない場合は、次のURLに移動してログインしてください：**

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

Splunkホームページでは、Verkadaを含むさまざまな統合用のすべてのアプリケーションが管理および構成されます。
{% endstep %}

{% step %}
**左上のAppsドロップダウンをクリックし、Find more appsを選択します。**

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

{% step %}
**Browse More Appsで：**

a. 検索ボックスに次を入力します **Verkada**。これにより2つのアプリケーションが表示されます。\
b. 最も最近更新されたVerkadaアプリケーション（**verkada add-on**）をインストールします。\
c.  **インストール** をクリックしてVerkadaアプリをインストールします。

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

{% step %}
**Login and Installで：**

1. Splunkアカウントの認証情報を入力してアカウントを確認します。

{% hint style="info" %}
これらの認証情報は、手順3で作成したものとは異なります。アプリをインストールするには、通常のSplunkアカウントにログインする際に使用したメールアドレスとパスワードを使用してください。（<https://www.splunk.com/>).
{% endhint %}

2. をクリックします **同意してインストール**.
   {% endstep %}
   {% endstepper %}

***

## Splunkbaseでソフトウェアをダウンロードしてインストールする

上記の [インストール方法](#h_c45403a4de) が機能しない場合は、ここで説明する代替方法があります。

{% stepper %}
{% step %}
**アプリを次からダウンロードしてください：** [**https://splunkbase.splunk.com/app/6971**](https://splunkbase.splunk.com/app/6971)**.**
{% endstep %}

{% step %}
**DownloadをクリックしてVerkada add-onアプリケーションをダウンロードします。**

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

{% step %}
**パッケージがダウンロードされたら：**

a. Splunk Enterpriseアカウントに戻ります。\
b.  **Apps** ドロップダウンから **アプリの管理**.
{% endstep %}

{% step %}
**Manage Appsで、右上のInstall app from fileをクリックします。**

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

{% step %}
**その後、新しいページにリダイレクトされ、Splunkインスタンスに追加するアプリケーションのインストールファイルを選択するよう求められます。**
{% endstep %}

{% step %}
**Install App From Fileで：**

a. クリック **ファイルを選択**。\
b.  **Downloads** フォルダで、最近ダウンロードしたファイル（**verkada-add-on\_126.tgz**）を見つけます。\
c. ファイルを選択して **Upload**.

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

{% step %}
**をクリックします。アプリがダウンロードされると、Appsの下のホームページにVerkada Add-Onタブが表示されるはずです。**

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

{% step %}
**Verkada Add-Onタブをクリックします。これにより新しいページにリダイレクトされ、そこでVerkada統合の設定と管理ができます。**

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

{% step %}
**Verkada Appページの右上にあるAdd Inputをクリックします。これにより、2種類の入力を作成できます：**

* **verkada\_insights** は、オーガナイゼーション'内の各カメラに対する物体検出情報を提供します。定期的な間隔で、検出された人物数と車両数、およびそれらのカウントに関連するタイムスタンプを表示します。
* **verkada\_notifications** は、Verkadaデバイスによって生成されたすべての通知の完全な一覧を提供します。
  {% endstep %}

{% step %}
**VerkadaのSplunk統合でのユースケースに応じて、verkada\_insights、verkada\_notifications、またはその両方の新しい入力を作成してください。**

{% hint style="warning" %}
​両方のオプションの結果を生成するには、各機能ごとに2つの পৃথ separate な入力を作成する必要があります。\
​
{% endhint %}
{% endstep %}

{% step %}
**入力を選択すると、以下の設定を入力するよう求められます：**

a. データ入力の一意の名前\
b. 各処理入力の時間間隔（秒）\
c. Index（推奨 **default**）\
d. Verkada Commandオーガナイゼーション' ID\
e.  [Verkada API key](https://apidocs.verkada.com/reference/quick-start-guide)。\
f.  **Add**.
{% endstep %}

{% step %}
**をクリックします。この新しいデータ入力を追加すると、手順11で作成した対応する名前とともに、VerkadaアプリのInputタブに表示されます。**

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

{% step %}
**統合が成功したことを確認します：**

a. 次に移動します **Search** タブ。\
b. 次を入力します **source="verkada\_insights"** または **source="verkada\_notifications"**、設定したデータ入力に応じて。

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

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

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

***

## トラブルシューティング

バージョン1.1.0から1.2.6に更新する際、新しい入力がすぐに表示されない場合があります。その場合は、以下の手順に従って問題を解決してください：

* Splunkインスタンスを再起動し、アカウントに再度ログインします。
* 3つの入力がそれでも表示されない場合は、Verkada Add-On Appを削除して再インストールしてください：
  1. Splunkアプリケーションのディレクトリに移動します。
  2. 次のフォルダを削除します `SPLUNK_HOME/etc/apps/TA-verkada-add-on`.

{% hint style="info" %}
変更を有効にするには、Splunkインスタンスの再起動が必要な場合があります。
{% endhint %}

3. SplunkからVerkada Add-Onアプリケーションをダウンロードするために、このセットアップガイドの手順1に戻ってください。
4. これでVerkadaアプリケーションの下に新しい入力が表示されるはずです。

データ取得エラーの原因となる可能性のある、他の一般的な問題もあります：

* 期限切れのVerkada APIキー。
* Commandオーガナイゼーション' IDが正しくない

進行中の統合問題をより詳細に把握するには、ユーザーは次の場所にある完全なSplunkログにアクセスできます： `SPLUNK_HOME/var/log/splunk`。ログレベルはアドオンの設定タブで調整できます。


---

# 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/ja/ganaizshon/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.
