Grafana †

• http://grafana.org/
  • オープンソースの可視化ツール
  • 複数のデータソースに対応し、ダッシュボードやグラフを作成できる。
  • プラグインでデータソースを追加できる
  • プラグインでパネル、データソースを追加できる
    • CloudWatch
    • Zabbix
    • Elasticsearch
  • Grafana - Grafana Documentation Site
  • 管理画面のLDAP認証対応
  • ansible, chef, docker, puppet等でデプロイできる Grafana - Installing via provisioning tools

• grafana/CHANGELOG.md at master · grafana/grafana

• 記事
  • Grafanaでかっけぇダッシュボード作るよ！(構築・設定編) | サーバーワークス エンジニアブログ

---

adminユーザのパスワードを忘れたら †

• DBに登録されるため、/etc/grafana/grafana.ini の admin_password を変えて、grafana-server を再起動しても反映されない。
• default passwordの'admin' へ変更する場合

sudo sqlite3 /var/lib/grafana/grafana.db
sqlite> update user set password = '59acf18b94d7eb0694c61e60ce44c110c7a683ac6a8f09580d626f90f4a242000746579358d77dd9e570e83fa24faa88a8a6', salt = 'F3FAxVm33R' where login = 'admin';
sqlite> .quit

---

Direct link rendered image: 画像へのリンクを取得 †

チャットに画像を直接貼りたい。

• http://docs.grafana.org/reference/sharing/#direct-link-rendered-image

• 注意点
  • 画像のURLにも認証が入るため、認証がONの場合見えない。

1. グラフをクリック > Share
2. Direct link rendered imageをクリックすると、画像取得できるURLが発行されるのでコピペ
3. チャットアプリによっては末尾に画像の拡張子が必要なので「#.png」を付ける

---

サンプルテンプレート †

• monitoringartist/grafana-aws-cloudwatch-dashboards: 20+ Grafana dashboards for AWS CloudWatch metrics: EC2, Lambda, S3, ELB, EMR, EBS, SNS, SES, SQS, RDS, EFS, ElastiCache, Billing, API Gateway, VPN, ...

---

Elasticsearch †

• 記事

• GrafanaでElasticsearchのデータを表示する - designetwork

---

バックアップ＆リストア †

DBのバックアップを取るだけ。

---

sqlite3の場合 †

• バックアップ：毎日1回、最大7日の場合

  sudo nice sqlite3 /var/lib/grafana/grafana.db .dump | gzip > grafana.sqlite3.$(date +%w).gz

• リストア:

  sudo service grafana-server stop
  sudo mv /var/lib/grafana/grafana.db /var/lib/grafana/grafana.db.$(date +%Y%m%d)
  zcat grafana.sqlite3.1.gz | sudo sqlite3 /var/lib/grafana/grafana.db
  sudo chown grafana:grafana /var/lib/grafana/grafana.db
  sudo service grafana-server start

---

設定ファイル †

• CentOS 7
  • /etc/grafana/grafana.ini

    [paths]
    # sqlite3のDBファイル等
    data = /var/lib/grafana
    # ログファイルのパス
    logs = /var/log/grafana
    [database]
    # sqlite3のDBファイル名
    path = grafana.db
    type = sqlite3

---

ログの出力先変更 †

CentOS 7で同じ内容のログが出ている場合、変更できる。

• mode
  • console: /var/log/messages
  • file: /var/log/grafana/grafana.log
  • console, file: 両方に出力する

• /var/log/grafana/grafana.log だけにする

  sudo vim /etc/grafana/grafana.ini
  --
  [log]
  ...
  mode = file
  --
  sudo service grafana-server restart

---

Templating: テンプレート化 †

Grafana 2.1からの機能。変数を定義して、変数に応じてグラフを切り替える事ができる。
変数自体は固定値だけでなく、データソースも指定できるため、動的に変更があっても、Grafana側の変更は不要にできる。
データソース自体も選択可能にできる。

• Templating | Grafana Documentation

• 記事
  • Grafanaで同じグラフを大量に作る (Repeating Rows and Panels) - Qiita

---

関数 †

• Functions - Grafana-Zabbix Documentation

• top(10, avg)
  • 複数アイテムがあった場合、上位10件を表示

• bottom(10, avg)
  • 複数アイテムがあった場合、下位10件を表示

• groupBy(interval, function)
  • 時間単位でアイテムの最大、最小、平均等を求める

• sumSeries()
  • 複数のアイテムの合計。CPU負荷が高いのでgroupBy()と合わせて使う事推奨

• setAlias(alias)
  • グラフ上に別名として表示できる

---

単位 †

• 記事
  • ギビバイト - Wikipedia

• サイズの表記が複数あるが、グラフのAxesタブ > Unit上の表記は同じ「bytes」なので注意。
  • data (IEC) bytes: GiB表記。2進数での表示。通常コンピュータ上の表記はこちら
  • data (Metric) bytes: GB表記。10進数での表示。

---

Zabbix †

• Zabbixは複数ホストの重ねグラフはテンプレートできなかったり苦手。その部分はGrafanaにまかせる
• 複数ホストのアイテム表示に正規表現「/hostname/」等が使える
• ZabbixはGB表記だが、GrafanaグラフのUnitは「data (IEC) bytes」を選択すると正しい値になる。

• 記事
  • Zabbixの監視情報をGrafanaでグラフィカルなダッシュボードに！！ | OSS on Azure 技術ブログ
  • まだ、Zabbixの見づらいグラフで消耗しているの！？ 「Zabbix plugin for Grafana」でグラフを見やすくする方法 : 元うなぎ屋

• Usage · alexanderzobnin/grafana-zabbix Wiki · GitHub

---

Direct DB Connectionで高速化 †

• SQL Data Source Configuration - Grafana-Zabbix Documentation

• 記事
  • Grafana-ZabbixでDirect DB Connectionを使ってみた - aoishiの備忘録

---

複数zabbixのデータソースのテンプレート化 †

• Templating例：dev/prodとzabbixが2つあり、データソースを切り替えたら、host groupも変わるようにする。
  • Variable:
    • Name: data_source_zabbix
    • Type: Datasource
  • Data source options:
    • Type: Zabbix
  • Variable:
    • Name: zabbix_host_group
    • Type: Query
  • Query Options:
    • Data source: $data_source_zabbix
    • Refresh: On Dashboard Load (これにしないと、zabbix_host_groupに追加された場合でも出て来ない？)
    • Query: *
    • Sort: asc

---

複数ホスト上の同じ項目の合計 †

• 複数ホスト(web01,02)上の同じ項目のアイテムを合計してグラフに表示する

• Metricsタブ > Query Mode: Metrics
• Group: $zabbix_host_group
• Host: /web.+/
• Item: access count per min
• Functions: groupBy(1m, avg) sumSeries() setAlias(access count)
• Panel data source: $data_source_zabbix

---

plugins: プラグイン †

• Grafana Plugins - extend and customize your Grafana. | Grafana Labs
  • panel: Pie Chart, Cal-HeatMap?, 他。AWS CloudWatch?はデフォルトで入っている。
  • datasource: Zabbix, Elasticsearch, DataDog? 他。AWSはデフォルトで入っている

• https://grafana.com/orgs/grafana
  • Grafana Labs作プラグインはデフォルトで追加しても良いだろう

---

一覧 †

sudo grafana-cli plugins ls
installed plugins:
alexanderzobnin-zabbix-app @ 3.8.1

---

更新 †

• pluginの更新があると、Home DashboardのInstalled Appsに通知される。
• Up to dateリンクから更新方法の案内が見えるので簡単

• 例: CentOS 7

  # 全て更新する場合
  sudo grafana-cli plugins update-all
  
  # 指定pluginのみ更新
  sudo grafana-cli plugins update alexanderzobnin-zabbix-app
  
  sudo service grafana-server restart

---

追加 †

• 例: CentOS7上の「zabbix」プラグインを追加

  sudo grafana-cli plugins install alexanderzobnin-zabbix-app
  sudo service grafana-server restart

---

アップグレード †

• Upgrading | Grafana Documentation

• pluginは自動更新されないので更新する

  sudo grafana-cli plugins update-all
  sudo service grafana-server restart

---

インストール †

• Installing via provisioning tools | Grafana Documentation

• Ansible, Puppet, Docker, Chef
• picotrading/ansible-grafana: Role to install and configure Grafana ansible roleが楽で良い

• Installing on RPM-based Linux | Grafana Documentation

• デフォルトURL: http://localhost:3000/
• デフォルトuser/password: /etc/grafana/grafana.ini
  • [security] セクション