Memo/Grafana

https://dexlab.net:443/pukiwiki/index.php?Memo/Grafana 		 

Grafana †

↑

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

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

データソース †

↑

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

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

ユーザ認証 †

↑

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

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

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

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

↑

ValidationError: 1 validation error detected: Value 'REMOVE_EMPTY(SEARCH('... †

  • Grafana v6.5.2
  • 原因: 検索に使う文字列が1024文字を超えている？
  • 解決: 検索に使う文字列を短くする。
    • Allでエラーが出る場合: Valiables > 変数名 > Custom all value: *
↑

too many datapoints requested in query B. Please try to reduce the time range †

  • Grafana v6.5.2
  • 原因: 1回のクエリのデータポイント数を超えている
  • 解決: 1回のクエリのデータポイント数を減らす
    • QueryのPeriodを許容出来る範囲で伸ばす: 5m
    • QueryのMin time intervalを許容出来る範囲で伸ばす: 5m (5分。300だと「Invalid interval string, expecting a number followed by one of "Mwdhmsy」エラーになるメトリクスもあった。HTTPCode_Backend_4XX等)
    • Periodを5mにすると、sumの場合に1mと値が異なるので注意。
    • 右上のタイムレンジを短くする
↑

Grafana v6.5〜大きいクエリでエラーになる †

  • Upgrading to v6.5
    • GetMetricStatistics APIの代わりに、GetMetricData APIを使用するようになった。
    • 1ダッシュボード1クエリを実行している。
    • GetMetricData API の制限
      • 1度に100クエリまで。
      • 50〜100 TPSの制限がある。TPSの上限は AWS Service Quotas console から引き上げ申請が出せる
    • 条件式は1024文字まで。templatingで使う変数が長くなるとエラーになる。
    • Allの場合は"*"を明示的に指定するのが良さそう
↑

全画面スクリーンショット †

v6.5.2現在取れない。issueの最後に加工は必要だが取る方法が書いてある。

  • NG: Chrome dev tools
  1. chromeでgrafanaを開く。例: https://play.grafana.org/d/000000012/grafana-play-home?orgId=1 グラフのロードが完了したら、dev tools (F12)を開く
  2. 以下コマンドで高さの取得 
    document.querySelector('.react-grid-layout').style.height;
  3. 取得したheightを指定して実行 
    docker run --cap-add=SYS_ADMIN timoschwarzer/capture-website-cli capture-website \
--full-page \
--overwrite \
--output=screenshot.png \
--element='.react-grid-layout' \
--height=1056 \
'https://play.grafana.org/d/000000012/grafana-play-home?orgId=1' > screenshot.png
↑

GitHub stats †

↑

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

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

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

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

↑

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

↑

正規表現 †

  • 「web01」と「web01-test」が混在していて、testを除外する。 
    /web(?!.*test)/
  • 「test」と「example」を除外。 
    /^(?!.*test|.*example)/
↑

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

↑

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: 画像へのリンクを取得 †

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

  • 注意点
    • 画像のURLにも認証が入るため、認証がONの場合見えない。
  1. グラフをクリック > Share
  2. Direct link rendered imageをクリックすると、画像取得できるURLが発行されるのでコピペ
  3. チャットアプリによっては末尾に画像の拡張子が必要なので「#.png」を付ける
↑

サンプルテンプレート †

↑

Elasticsearch †

  • 記事
↑

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

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側の変更は不要にできる。
データソース自体も選択可能にできる。

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

単位 †

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

アップグレード †

  • pluginは自動更新されないので更新する 
    sudo grafana-cli plugins update-all
sudo service grafana-server restart
↑

インストール †

  • デフォルトURL: http://localhost:3000/
  • デフォルトuser/password: /etc/grafana/grafana.ini
    • [security] セクション
トップ   編集 凍結 差分 バックアップ 添付 複製 名前変更 リロード   新規 一覧 単語検索 最終更新   ヘルプ   最終更新のRSS
Last-modified: 2020-08-05 (水) 14:36:42 (6d)