# Splunk

Splunkは、組織がさまざまなサードパーティソースからのデータを検索、監視、分析するのに役立つソフトウェアプラットフォームです。Verkadaは組み込みの統合を通じて、Command組織からSplunkインスタンスへ情報を効率的なワークフローで送信するための構築を可能にします。

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

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

* Adminアクセスを持つ有効なSplunkインスタンス。詳細は [Commandの役割と権限](https://help.verkada.com/command/ja/yzto/roles-and-permissions-for-command).
* あなたの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="https://1706941156-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 %}
**実行しているオペレーティングシステム（Windows、Linux、またはMacOS）に応じて、対応するインストールパッケージを選択します。簡単なセットアップのために.dmgパッケージのダウンロードを推奨します。**

<div align="left" data-with-frame="true"><img src="https://1706941156-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 %}
**Splunk Enterpriseパッケージをインストールしたら、アプリケーションを開きます。アカウント資格情報（ユーザー名とパスワード）を作成できるターミナルまたはPowerShellのウィンドウにリダイレクトされるはずです。**

​\
​**重要**：これらの資格情報を保存してください。後でSplunkにログインしてVerkada統合を設定する際に必要になります。アカウントを作成すると、アカウント確認のためのメールが届きます。受信箱を確認し、この手順を完了してからセットアップを続行してください。
{% endstep %}

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

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

<div align="left" data-with-frame="true"><img src="https://1706941156-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>

Splunkのホームページは、Verkadaを含むさまざまな統合用アプリケーションを管理および設定する場所です。
{% endstep %}

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

<div align="left" data-with-frame="true"><img src="https://1706941156-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 %}
**Browse More Appsでは：**

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

<div align="left" data-with-frame="true"><img src="https://1706941156-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 %}
**Login and Installでは：**

a. Splunkアカウントの資格情報を入力してアカウントを確認します。\
​\
​**注：** これらの資格情報は手順3で作成したものとは異なります。アプリをインストールするには、一般のSplunkアカウントにログインする際に使用したメールとパスワードを使用してください（<https://www.splunk.com/>）。\
​\
b.  **Agree and Install**をクリックします。\
​

<div align="left" data-with-frame="true"><img src="https://1706941156-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 %}

***

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

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

{% stepper %}
{% step %}
**アプリは次からダウンロードします** [**https://splunkbase.splunk.com/app/6971**](https://splunkbase.splunk.com/app/6971)**.**
{% endstep %}

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

<div align="left" data-with-frame="true"><img src="https://1706941156-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 %}
**パッケージがダウンロードされたら：**

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

{% step %}
**を選択します。**

<div align="left" data-with-frame="true"><img src="https://1706941156-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 %}
**Manage Appsで、右上のInstall app from fileをクリックします。**
{% endstep %}

{% step %}
**次に、追加したいアプリケーションのインストールファイルを選択するよう促す新しいページにリダイレクトされます。**

Install App From Fileでは： **a.** Choose File **をクリックします。**\
**b. ご自身の** Downloads**フォルダで、最近ダウンロードしたファイル（**&#x76;erkada-add-on\_126.tgz **）を見つけます。**\
**c. ファイルを選択して**.

<div align="left" data-with-frame="true"><img src="https://1706941156-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 %}
**Upload**

<div align="left" data-with-frame="true"><img src="https://1706941156-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 %}
**をクリックします。**

<div align="left" data-with-frame="true"><img src="https://1706941156-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 %}
**アプリがダウンロードされると、Appsの下にVerkada Add-Onタブがホームページに表示されるはずです。**

* **Verkada Add-Onタブをクリックします。これにより、新しいページにリダイレクトされ、そこでVerkada統合の設定と管理ができます。** Verkadaアプリページの右上でAdd Inputをクリックします。これにより、次の2種類の入力を作成できます：
* **verkada\_insights** は組織内の各カメラに関するオブジェクト検出情報を提供します。定期的な間隔で検出された人物および車両のカウントと、それらのカウントに関連するタイムスタンプを表示します。
  {% endstep %}

{% step %}
**verkada\_notifications**

はVerkadaデバイスによって生成されたすべての通知の完全なリストを提供します。**VerkadaのSplunk統合でのユースケースに応じて、verkada\_insights、verkada\_notifications、または両方の新しい入力を作成してください。**&#x200B;
{% endstep %}

{% step %}
**注**

：両方のオプションで結果を生成するには、各機能ごとに2つの別々の入力を作成する必要があります。\
​ **入力を選択すると、次の設定を入力するよう求められます：**&#x61;. データ入力の一意の名前\
b. 各処理入力の時間間隔（秒単位）\
c. インデックス（推奨 [default](https://apidocs.verkada.com/reference/quick-start-guide)）\
d. あなたのVerkada Command組織ID\
e. あなたの **Verkada APIキー**.

<div align="left" data-with-frame="true"><img src="https://1706941156-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 %}
**。**\
**f.**&#x20;

<div align="left" data-with-frame="true"><img src="https://1706941156-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 %}
**Add**

をクリックします。 **この新しいデータ入力を追加すると、手順11で作成した対応する名前でVerkadaアプリのInputタブに表示されます。** 統合が成功したことを確認します： **a.** Search **タブに移動します。**\
**b. 次を入力します：**&#x73;ource="verkada\_insights"

<div align="left" data-with-frame="true"><img src="https://1706941156-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://1706941156-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://1706941156-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 %}

***

## または

source="verkada\_notifications"

* （構成したデータ入力に応じて）。
* トラブルシューティング
  1. バージョン1.1.0から1.2.6にアップデートする際、一部の新しい入力がすぐに表示されない場合があります。もしそのような場合は、以下の手順に従って問題を解決してください：
  2. Splunkインスタンスを再起動し、アカウントに再度ログインします。 `それでも3つの入力が表示されない場合は、Verkada Add-Onアプリを削除して再インストールしてください：`.

     **注：** Splunkのアプリケーションディレクトリに移動します。
  3. フォルダを削除します
  4. SPLUNK\_HOME/etc/apps/TA-verkada-add-on

変更を有効にするためにSplunkインスタンスを再起動する必要がある場合があります。

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

データ取得エラーにつながる可能性のあるその他の一般的な問題： `Verkada APIキーの有効期限切れ。`Command組織IDが正しくない場合があります。
