Memo/Grafana

• Memo/Grafana/API
• Memo/Grafana/Athena
• Memo/Grafana/CloudWatch
• Memo/Grafana/docker
• Memo/Grafana/Loki
• Memo/Grafana/plugins
• Memo/Grafana/Troubleshooting
• Memo/Grafana/Zabbix

Grafana †

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

• 変更履歴: grafana/CHANGELOG.md - GitHub

• https://play.grafana.org/
  • サンプルが見れる

• https://grafana.com/tutorials/
  • plugin開発のチュートリアル等もある

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

---

Managed Grafana †

• 多くの新機能を備えた Amazon Managed Grafana が一般公開されました | Amazon Web Services ブログ
  • アクティブユーザ数課金: 編集者 $9/month, 閲覧のみ $5/month

記事:

• Amazon Managed Grafana が Amazon Athena および Amazon Redshift データソースと Geomap の視覚化のサポートを追加

---

variables: 内部変数 †

• Global variables | Grafana Labs

• Grafan a 7.1.2+以降でtime range変数 $__from , $__to が使えるようだ
  • ${__from:date:YYYY-MM} 2020-07

---

CSVのダウンロード †

1. グラフタイトルにカーソルを合わせ「v」をクリック -> Inspect > Data > Download CSV

---

データソース/ダッシュボード/Plugin/Alertをファイルで管理 †

• Provisioning | Grafana Labs
  • v5.0以降でファイルで管理できるようになった。それ以前はAPIから登録だった。git等で管理する場合、DBバックアップが不用になるため、ファイルの方が楽かも。

• 記事
  • GrafanaのDashboard等をファイルで管理する - Qiita

---

データソース †

• grafana_datasource – Manage Grafana datasources — Ansible Documentation
  • ansibleで管理できる。カスタムデータソースは不明

• AWS Athena

AWS S3 select:

• tvarit-foggy/grafana-s3-plugin

---

データソースのリネーム †

• SQLiteを見る限り、データソースが固定文字列として各ダッシュボード、アラートに埋め込まれているため、GUI上からは一括リネームができない。
• データソースだけをリネームすると、各ダッシュボード、アラート側は変わらないためグラフが出なくなる。

• Issue
  • Renaming data source does not update graphs · Issue #1664 · grafana/grafana

• grafana_dashboard – Manage Grafana dashboards — Ansible Documentation
  • ansibleでダッシュボードのImport/Exportは出来る。一覧を取得するmoduleはまだ無い？

• knoguchi/grafana-dash: A utility to update Grafana dashboards
  • python3, pip3 install grafana_api, jq 1.6 が必要

    git clone https://github.com/knoguchi/grafana-dash.git
    cd grafana-dash/
    pyenv local 3.6.8
    python -V
    Python 3.6.8
    
    pip3 install grafana-api
    
    jq -V
    jq-1.6
    
    vi grafana.rc
    --
    export GRAFANA_URL=http://192.168.xxx.xxx:3000
    export GRAFANA_ADMIN_USER=admin
    export GRAFANA_ADMIN_PASS=admin
    export GRAFANA_ORG="Main Org."
    --
    
    source grafana.rc

  • Datasource update script: このコマンドで出来そう
  • alertの変更には非対応。データソースがあると失敗する。
  • update-datasource.jq はjq 1.6以上が必要。macOSはジバン(shebang)にオプションを付与できるようだが、 Linux系では動かない。Linuxで動かすためには、

    jq -Mf update-datasource.jq ...

---

ユーザ認証 †

• Authentication HTTP API | Grafana Labs
  • basic認証
  • API key認証

---

小数点以下の表示桁数の指定 †

CloudWatch等のmetricsは浮動小数点が多すぎで見にくい場合がある。

• https://grafana.com/docs/grafana/latest/features/panels/graph/

• Grafana v6.5.2
• Graph > Legend Tab > Decimals
• X, Y軸それぞれに設定できる。
• Decimals:1 だと、小数点以下1桁を表示する。tableやHover tooltipの数値には効かないようだ。

---

GitHub stats †

• GitHub Repo Issue Analytics dashboardData for Grafana | Grafana Labs
• GitHub Repo Comment Analytics dashboardData for Grafana | Grafana Labs

---

Graph上の0,nullのメトリクスを隠す †

メトリクスが多く、0やnullを非表示にしたい場合:

• 環境
  • Grafana 5.x

1. Graph > Legend タブ
2. Hide series
   • With only nulls: nullを隠すにチェック
   • With only zeros: 0 を隠すにチェック

---

Annotations: グラフ上にイベント発生日時、タグ、メッセージを残せる †

• Annotations | Grafana Documentation
  • 例: deploy日時をグラフ上に残し、メトリクスへの影響を見る

• 記事
  • Grafana annotation + Prometheus で試験結果をさっくりまとめよう - Qiita

---

Scripted Dashboards: javascriptでカスタムダッシュボード作成 †

• Scripted Dashboards | Grafana Documentation

• 記事
  • Grafana の scripted dashboards を利用してダッシュボードを自動生成する - クックパッド開発者ブログ

---

正規表現 †

• Filter variables with regex | Grafana Labs
  • Grafana v8から仕様が変わった？v7で使えた正規表現が動作しない

除外:

• NG: v8.4.3
• OK: v7.0.6
• 「web01」と「web01-test」が混在していて、testを除外する。

  /web(?!.*test)/

• 「test」と「example」を除外。

  /^(?!.*test|.*example)/

---

Playlist: 一定時間毎にダッシュボードを切り替える †

• Playlist | Grafana Documentation

---

ROW OPTIONS: 行単位のグループ化 †

• 同系統のメトリクスをまとめる。
• 行単位で隠しておける。クリックすると表示。複数系統のメトリクスを纏めると縦に長くなりがちなので、スクロールを減らせる。

Grafanaのバージョンによって、ROW OPTIONの位置が変わった。

• v5.x: layout managerが変わって、ROWがpanelに変わった。ROWがデフォルトで不用になった代わりに、行に余白があると自動でグラフの配置が詰められる。

1. Add panel
2. Row panelを選択

• v4.x以下: ROW単位だった

1. Dashboard左下のAdd ROW

---

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

• DBに登録されるため、/etc/grafana/grafana.ini の admin_password を変えて、grafana-server を再起動しても反映されない。

• grafana-cliから変更できるようだ。Reset admin password

  sudo grafana-cli admin reset-admin-password <new password>

• 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

• グラフ
  • General > Titleで「$var_name」で参照できる。
  • Metrics > Aliasで「{{dimension_name}}」で参照できる。$var_nameではなく、結果に含まれるMetrics名になる。

    {{metric}}
    {{stat}}
    {{namespace}}
    {{region}}
    {{period}}
    {{YOUR_DIMENSION_NAME}}

---

単位 †

• 記事
  • ギビバイト - Wikipedia

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

---

アップグレード †

• 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] セクション

Software

• 自作ソフト
• wiki自作プラグイン
• 利用規定
• ランキング
• 雑誌等掲載履歴

Programming

Game

雑記

連絡先

---

• MenuBar
• RightBar
• :admin
  

人気の10件

最新の10件

---