plugins: プラグイン †

• https://grafana.com/grafana/plugins
  • panel: Pie Chart, Cal-HeatMap?, 他。AWS CloudWatch?はデフォルトで入っている。
  • datasource: Zabbix, Elasticsearch, DataDog? 他。AWSはデフォルトで入っている

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

pluginの開発 †

• Build a plugin. | Grafana Labs

• チュートリアル
  • Build a data source plugin | Grafana Labs

• 記事
  • Grafanaデータソースプラグインの作り方[その１]｜ケンジ｜note

未登録のpluginを追加する †

• https://grafana.com/grafana/plugins に未登録なpluginでも、grafana-cliから登録できる
• allow_loading_unsigned_plugins に許可するpluginをカンマ区切りで入力する
  • Grafana v7.xでは unsignedなpluginがloadされない。
  • /var/log/grafana/grafana.log に出るエラー

    [...] lvl=warn msg="Some plugins failed to load" logger=plugins errors="[plugin \"mtanda-aws-athena-datasource\" is unsigned]"

grafana-aws-athena-datasource †

https://github.com/mtanda/grafana-aws-athena-datasource の場合

• https://github.com/mtanda/grafana-aws-athena-datasource/blob/master/src/README.md 以下にREADMEがある
• v2.2.5は、Grafana v7.0.6 で動作した。 v7.1.0では動作せず。v7.x未満の場合、データソースの登録画面でエラーが出て、GUIでは消せないデータソースが増えるので、APIで消す。
  • v2.2.5: Grafana v6.5.2 〜 v6.7.4でのエラー

    Error: Object prototype may only be an Object or null: undefined Evaluating

  • Memo/Grafana/API で壊れたデータソースを消す方法

1. https://github.com/mtanda/grafana-aws-athena-datasource/releases からzipのurlをコピー

   sudo grafana-cli --pluginUrl https://github.com/mtanda/grafana-aws-athena-datasource/releases/download/2.2.5/grafana-aws-athena-datasource-2.2.5.zip plugins install mtanda-aws-athena-datasource

2. CentOS 7の場合: /var/lib/grafana/plugins/ に展開される。
3. Grafanaの再起動

   sudo service grafana-server restart

4. Grafana v7.xでは unsignedなpluginがloadされないため、allow_loading_unsigned_plugins に許可するpluginをカンマ区切りで入力する

   sudo vim /etc/grafana/grafana.ini
   --
   [plugins]
   allow_loading_unsigned_plugins =  mtanda-aws-athena-datasource
   --
   sudo service grafana-server restart

5. Grafana > Configration > Data Souces > AWS Athena datasourceが選択し、Test&Saveでエラーが出なければOK

• Query stringを実行するのに必要だった権限

  {
      "Version": "2012-10-17",
      "Statement": [
          {
              "Sid": "GrafanaAthena",
              "Effect": "Allow",
              "Action": [
                  "athena:StartQueryExecution",
                  "athena:ListWorkGroups",
                  "athena:ListQueryExecutions",
                  "athena:ListNamedQueries",
                  "athena:GetWorkGroup",
                  "athena:GetQueryResults",
                  "athena:BatchGetQueryExecution",
                  "athena:BatchGetNamedQuery"
              ],
              "Resource": "*"
          },
          {
              "Sid": "GrafanaAthenaS3",
              "Effect": "Allow",
              "Action": [
                  "s3:PutObject",
                  "s3:ListMultipartUploadParts",
                  "s3:ListBucketMultipartUploads",
                  "s3:ListBucket",
                  "s3:GetObject",
                  "s3:GetBucketLocation"
              ],
              "Resource": [
                  "arn:aws:s3:::bucket/*",
                  "arn:aws:s3:::bucket"
              ]
          }
      ]
  }

ダウングレード †

• alexanderzobnin-zabbix-app 3.10.3を入れるとエラーで表示されなくなったため、一つ前のバージョンに戻す場合。

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

一覧 †

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