とりあえず、作業用のEC2にインストールしてるmkrをアップデートします。

$ yum check-update
...
mkr.x86_64        0.44.1-1.amzn2        mackerel
...
$ sudo yum update -y mkr
...
Complete!
$ mkr --version
mkr version 0.44.1 (rev:fa78822)

$ mkr dashboards --help

NAME:

   mkr dashboards -

    Manipulate custom dashboards. With no subcommand specified, this will show all dashboards. See https://mackerel.io/docs/entry/advanced/cli

USAGE:

   mkr dashboards command [command options] [arguments...]

COMMANDS:

   generate  Generate custom dashboard

   pull      Pull custom dashboards

   push      Push custom dashboard

   migrate   Migrate a legacy dashboard

OPTIONS:

   --help, -h  show help

ちゃんとdashboardsコマンドに pull / push あたりがあります。
まだヘルプにファイルの形式とか反映されてないのでとりあえず今あるダッシュボードをpullして定義を見てみることにします。

$ mkr dashboards pull

      info Dashboard file is saved to 'dashboard-hogehoge.json'(title:HogeHoe)
      ....

      info Dashboard file is saved to 'dashboard-fugafuga.json'(title:FugaFuga)

なるほど、新しいダッシュボードの定義はJSONなんですね（レガシーダッシュボードの定義はYAMLだったはず）。
ちなみに、 「dashboard-hogehoge.json」のhogehoge部分はダッシュボードのID（カスタムURLを変更してなければURLのパス）になります。
カスタムURLを変更していてもIDで落ちてくるので、注意です。（とは言え、親切にtitleを一緒に出してくれるのでどれがどのダッシュボードのファイルかはわかると思います。ファイル内にもダッシュボード名は入っています）

ダッシュボードの定義JSONのサンプルは以下のような感じになります。


type / title / layout / metric / graph / range / markdownあたりのキーが見えます。
詳しく見ていくと、typeによって設定するキーが違うように見えます。
typeがgraphだとgraphに定義を書いて、valueだとmetric、markdownだとmarkdownに書いていくように見えます。layoutはダッシュボードの編集画面みたことがある人はわかると思いますが、グリッド上の配置を記載していますね。

ということで、このjsonを少し修正（idを別の空のダッシュボードにセット、createdAtとかupdatedAtとかを削除）してpushしてみます。
pushコマンドは --file-path もしくは -F オプションでファイルを指定します。

$ mkr dashboards push -F dashboards-hogehoge.json

     error API request failed: Invalid Parameter: obj.widgets[1] 'roleFullname' is undefined on object: {"type":"alertStatus","title":"Alert Status","layout":{"x":6,"y":0,"width":4,"height":3},"metric":null,"graph":null,"range":null}.

はい、エラーが出ました。
「AlertStasusなウィジェットに必要な定義 `roleFullname` がないぞ」というエラーですね。
JSONみた時にそんな気はしてました。
なので、push試す前にサポートに「これ、AlertStatusに定義なくて大丈夫？」という追加の質問していますし、pushでエラーが出たのを確認して追加の情報として上記のエラーメッセージも伝えていますので、そのうち直ると思います。

ということで、AlertStatusのウィジェットは一旦消して再度pushをしたところ、無事に成功して新しいカスタムダッシュボードができていました！バンザイ！

mkr dashboards pullしたjson、500行超えててやはり人類がjsonで設定書くのは厳しい（俺にはyqがある

— (っ’ヮ’c) ＜ ★しっぽ (@ryosms) February 19, 2021

そんなこんなで、このダッシュボードの定義をGitで管理できるようにやっていきます。
とりあえず、個人的にJSONで管理するのは辛いので、yqを使ってYAMLに変換します。
その後、サービス固有の情報（ダッシュボードのID、タイトル、サービス名、ホストID等）を変数化していきます。例えば、サービス名を「${SERVICE_NAME}」という形に変換しておきます。
サービス名等はenvファイルとかにして別ファイルで管理します。
こいつはGitでは管理しない想定ですが、特にクレデンシャルな情報が入っているわけでもない（せいぜい、Mackerel上でのIDくらい？）ので、Gitにコミットしてしまってもいいかもしれません。

で、環境が増えたり、Webでダッシュボードをついうっかり壊してみたり、ダッシュボードの定義を少し変更してみたりした場合には以下のコマンドで簡単にダッシュボードを復元できるようになります。