【Splunk】ダッシュボードのドリルダウンと動的パラメータ

##はじめに
[前回の記事](https://qiita.com/lemongumicho/items/c65374caf8e23d82fb88)でSplunkの静的なダッシュボードを作りましたが、もう少し動的で対話型のダッシュボードを作る方法です。
Splunkレベル：初級
##使った環境
マネージャ
　Splunk Enterprise 6.6.6
クライアント
　VMサーバ3台(Windows2012)
　Apache v2.4
##ダッシュボードの動的パラメータ
###やりたいこと
入力した文字列をURLに含むデータを検索する。
###ダッシュボードを作成
![01_new_dashboard.png](https://qiita-image-store.s3.amazonaws.com/0/248691/1b85d9fd-8298-8a42-18c4-1d7e4177996e.png)
新しいダッシュボードの名前を「apache error detail」にします。

###パラメータの作成
ダッシュボードの編集から「+入力の追加」をクリックし「テキスト」を選択します。
![dashboard_hensyu.png](https://qiita-image-store.s3.amazonaws.com/0/248691/90861a7a-4479-4e9a-1789-9f66ae99a6fa.png)
![02_new_input.png](https://qiita-image-store.s3.amazonaws.com/0/248691/42447de5-90ed-a86d-a895-06182e1a308f.png)

テキストフィールドが作成されます。
![02_input_text.png](https://qiita-image-store.s3.amazonaws.com/0/248691/fef23c34-d7f3-60e0-8f8a-72a38e0e15ff.png)

Splunkでは動的パラメータを「トークン」という言い方をします。
鉛筆アイコンをクリックし編集ダイアログを出します。
![02_token_param.png](https://qiita-image-store.s3.amazonaws.com/0/248691/bac2cceb-a5b9-f681-b6b2-fb916eaacaf4.png)
デフォルトに「Update」、トークンプリフィックスに「uri_query="*」トークンサフィックスに「*"」を入力し、即座にサーチしたいので変更時にサーチにチェックを入れます。
『入力文字列を含む』なので前後に*を入れています。
適用ボタンを押して保存します。

プリフィックスとサフィックスはその名のとおり、入力の前後に付与する文字列になります。
単純文字列であればサーチ文につけることもできますが正規表現などはプリフィックス、サフィックスに設定したほうがよいと思います。

デフォルトと初期値の違いが説明を読んでも分かりにくいです。
デフォルトは「デフォルトの値」、
初期値は「ページロード時の値。デフォルトが指定されている場合無視されます」とあるので、両方指定されている場合デフォルトが優先になります。
ページロードでは同じ動作をし、実行ボタンでのサーチでの動作の違いだと思いますが、他にももしかしたら違いがあるかもしれません。

###サーチ連動
トークンの値とサーチを連動させます。
ダッシュボードの編集パネルからパネルの追加をクリック
![dashboard_hensyu.png](https://qiita-image-store.s3.amazonaws.com/0/248691/6323a6a9-3eb4-4b28-3e66-a31377d8a1f4.png)

イベントの追加をクリック
![03_new_add_panel.png](https://qiita-image-store.s3.amazonaws.com/0/248691/68ff0b1a-40f3-bc90-90a0-ad368503a82a.png)

サーチ文を追加します。
![04_search_feild.png](https://qiita-image-store.s3.amazonaws.com/0/248691/d8aba90a-cd2c-a3d6-f257-37a135bac1eb.png)
プリフィックスにフィールド名も書いているので「\$field1$」を追加するだけです。
適用ボタンを押し、ダッシュボードも保存します。

###サーチ結果
![04_search_result.png](https://qiita-image-store.s3.amazonaws.com/0/248691/de150937-d735-3de2-f491-378bc78e6a5c.png)
updateの文字列を含んだデータが検索できています。検索文字列を変更すれば当然ながら変更した文字列で再検索されます。

今回は簡易なパラメータでの検索ですが、たとえば『従業員ID』と『時間』をパラメータにOSログ、DBログ、アプリケーションログ等々をダッシュボード上でサーチして従業員Aさんの行動を分析すると言ったような使い方など、いろいろ用途は考えられると思います。

##ダッシュボードのドリルダウン
ダッシュボードの結果からサーチや他のダッシュボードにドリルダウンすることでより詳細な分析を行うことができます。
###やりたいこと
ダッシュボードからサーチへの連携
###ダッシュボードの設定
[前回](https://qiita.com/lemongumicho/items/c65374caf8e23d82fb88)作成したダッシュボードを使用します。
ダッシュボードを編集モードにし、対象のパネルの三点リーダー？のアイコンをクリックするとEdit Drilldownがあるのでクリックします。
![07_add_drilldown.png](https://qiita-image-store.s3.amazonaws.com/0/248691/97a71b74-4927-1150-6d2e-d2024a613f7c.png)
ドリルダウンエディタが開くので編集します。自動を選ぶと元のサーチ文のままサーチに連携されます。
![07_drilldown_edit.png](https://qiita-image-store.s3.amazonaws.com/0/248691/ba678a94-1d2a-7c29-83cd-045afe18ef3f.png)
カスタムを選ぶと新たなサーチを設定できます。トークンに設定されている値もサーチ文の一部として設定することができます。
![07_drilldown_edit_custom.png](https://qiita-image-store.s3.amazonaws.com/0/248691/ce7fb5a3-3045-2458-d33a-cf5419f35f64.png)
今回は自動で設定します。
###ドリルダウンの結果
適用ボタンで保存し、ダッシュボードも保存してダッシュボードに戻ると、グラフにアイコンを持っていくと指マーク(リンクあり）に変わります。(スクショだとアイコンが写らない。。)
![apache_dashboard.png](https://qiita-image-store.s3.amazonaws.com/0/248691/ef13def0-72b4-048c-9bcb-255c7ebf1ccc.png)
グラフをクリックするとサーチに連携されました。
![07_drilldown_reration.png](https://qiita-image-store.s3.amazonaws.com/0/248691/619b9064-1c2a-11f4-6cc9-3b44c0fecc78.png)
グラフの装飾に関する部分は自動で落とされてサーチに関する部分のみが連携されるようです。ただ、`TOP 5 status`の部分も落とされており必要なフィルタが落ちる可能性があるので注意が必要です。
またグラフからだと元のサーチ文のままサーチが開き、テーブルだとクリックしたデータをパラメータに追加されてサーチが開くようです。
##ダッシュボードからダッシュボードへのドリルダウン
###やりたいこと
ダッシュボードから詳細ダッシュボードへの連携
その際にクリックしたデータをダッシュボードのパラメータとして連携する。
今回は「apache dashboard」から「apache error detail」に連携させます。
###ダッシュボードの設定
先ほどと同じくエラー内容のパネルからEdit Drilldownをクリックします。
![08_add_drilldown.png](https://qiita-image-store.s3.amazonaws.com/0/248691/79a8b4ce-41c3-3ae3-6c65-8a77d69cf582.png)
OnClickに「ダッシュボードにリンク」を設定、ダッシュボードに上記で作成した「apache error detail」を設定します。
詳細のパラメータの「form.field2」=「\$click.value$」を設定します。
![08_drilldown_edit.png](https://qiita-image-store.s3.amazonaws.com/0/248691/f8a9fbe3-8f62-c257-bd7e-2a9214ccbd09.png)

clickしたときの値のとり方の一覧

|  変数名  |  取れる値  |
| ---- | ---- |
|\$click.name$  |  クリックしたデータの一番左のカラム名  |
|\$click.value$  |  クリックした行の一番左のデータ値  |
|\$click.name2$ | クリックしたデータのカラム名 |
|\$click.value2$ | クリックしたデータのデータ値 |

表データの一番左かクリックしたデータしか拾えないようです。
表にするとこんな感じ

 \$click.name$<br>(カラム名1)    |(カラム名2)   |(カラム名3)   | \$click.name2$<br>(カラム名4)     |(カラム名5)   |
|-----------------|---|---|-------------------|---|
|                 |   |   |                   |   |
| \$click.value$   |   |   | (ここをクリック)<br> \$click.value2$" |   |
| |   |   |                   |   |


今回はIPを連携するため、元の表の表示順の一番左にsrc_ipを設定し、\$click.value$で一番左のデータを渡すように設定しています。
適用ボタンをクリックし、ダッシュボードも保存してダッシュボードに戻ります。
###ダッシュボード連携の結果
![apache_dashboard.png](https://qiita-image-store.s3.amazonaws.com/0/248691/ef13def0-72b4-048c-9bcb-255c7ebf1ccc.png)
apache dashboardから「10.20.22.53」の行をクリックします。

詳細ダッシュボードが表示されます。
![08_drilldown_reration.png](https://qiita-image-store.s3.amazonaws.com/0/248691/02ef8210-0554-f316-4d9d-fc8a6635cd7c.png)
filed2のトークンに「Server2」が表示されており、URLにも10.20.22.53が詳細ダッシュボード渡されて検索されています。

ダッシュボードから詳細ダッシュボードへのドリルダウンは、ダッシュボード設計をきちんと行っておけば分析にかかる時間短縮になりそうです。

##資料
[Dynamic drilldown in dashboards and forms - Splunk ](http://docs.splunk.com/Documentation/Splunk/6.5.9/Viz/Dynamicdrilldownindashboardsandforms)