OneAgentは知らないうちにバージョンアップされる
DynatraceのOneAgentは、新しいバージョンが公開されると、デフォルトではOneAgent自身で自動バージョンアップします。これは手間いらずで便利なのですが、OneAgentに含まれる各種モジュールは、対象プロセスを手動で再起動して読み込みなおす必要があります。スクリーンショットのように注意書きが表示されます。OneAgentが自動バージョンアップされた後、各モジュールもスムーズに最新バージョンにするため、OneAgentがバージョンアップされたら通知するWorkflowを作成していきます。
OneAgentがバージョンアップされたらメールが届くようにします。
またこの記事は、定期実行されるWorkflowの結果を何らか保存し、次回の実行時に参照する方法について書いていますので、いろいろ応用できるかと思います。
Workflow概要
作成したWorkflowは以下の通りです。
1. トリガー
スケジュールで自動実行します。定期実行のトリガーアクションであるScheduleを選択し、6時間毎に実行するように設定しています。この間隔はお好みで調整してください。
2. 現在のOneAgentのバージョンを取得する
次の get_oa_new_version では、このWorkflowが実行されるEnvironmentに紐づいているOneAgentのバージョンのうち、最新のものを取得します。
DQLクエリのアクションで、ホスト情報からOneAgentのバージョンを取り出しています。複数ホストで複数のOneAgentのバージョンがある場合は最大のものを選んでいます。
DQLのクエリをノートブックにコピーして実行してみると以下のようになります。
バージョンを文字列として降順にソートし先頭行を取っています。なお、文字列比較なので 1.297.53 の 53 の部分が1桁の場合、例えば 1.297.7 と比較すると本当は後者の方が古いのですが、ソート順が上がるため誤検知につながることがありますので要改善です。
3. 過去のOneAgentのバージョンを取得する
次の get_oa_prev_version では、前回までのこのWorkflowの実行時に保存されたOneAgentのバージョンを取得します。
ここでポイントなのですが、前回までのWorkflowの実行結果をログとしてEnvironment内に保存しています。ですので、fetch logs でログを取得し、oneagent_version という属性がある行だけを抜き出しています。
Workflowの実行間隔によってはログが得られないことがあるので、前回の実行時のログが含まれるような期間を fetch logs, from: -12h などと指定してください。
ノートブックにクエリをコピーして実行してみます。イメージしやすくするため limit 1 をコメントアウトしています。
ログに保存されたOneAgentのバージョンと、そのバージョンが最後に記録されたタイムスタンプが表示されています。
limit 1 とすることで最初の行、つまりログに記録されている中から最新のバージョンが得られます。
4. 現在と過去のOneAgentのバージョンが異なっていれば通知する
次の send_mail アクションでは、2. と3. で取得したOneAgentのバージョンが異なっている場合に、バージョンアップされたと判断し通知を行います。
本記事ではメール送信アクションを使用していますが、SlackやJiraなどのアクションも利用可能です。
メッセージ本文には、2. や 3. で取得した情報を変数で埋め込んでいます。Preview で実際のメッセージを確認できます。（このPreviewでは新旧のバージョンが同じになっています。）
ポイントはConditionsです。
ここで 2. の get_oa_new_version の installerVersion と 3. の get_oa_prev_version の oneagent_version を比較し、異なっていれば通知を行います。同じであれば前回からはバージョンアップされていないので何もしません。!= で比較しているので、異なっていれば true、同じであれば false になります。
実行結果の例を見てみると、Conditionsがfalseの場合は、以下のように send_email のアクションはグレイアウトされていて実行されなかった (Discarded) ことが分かります。
5. Workflowの実行結果＝現在のOneAgentのバージョンをログとして記録する
最後に、今回のWorkflowで取得した、現在のOneAgentのバージョンをログとして記録します。
ここではJavaScriptアクションを使っていますが、HTTPアクションでAPI経由でログを記録することもできます。JavaScriptの場合は、実行ユーザー（任意に設定可能）に割り当てられている権限で動作するため、場合によっては使いづらいことがあるかもしれません。HTTPであれば専用のトークンを作っておけば権限を固定しておくことが容易です。一方HTTPの場合はトークンやURLなど、Environmentに固有の情報が含まれるため、複数のEnvironmentで共用したい場合には使いづらくなります。JavaScriptの場合は、さらに前後でデータの加工など追加の処理も書けるため、より柔軟性が高いです。
ログ本体はJSONで送っています。JSONで送っておくと属性値を取り出す際に使いやすいです。実際のログ行は以下のようになります。（以下は10分間隔でWorkflowを実行した例）
おまけ: ActiveGateの場合
ActiveGateのバージョンアップも通知したい、という場合には、現在のバージョンの取り出し方が少し変わります。DQLでアクセスできる情報に含まれていないため、JavaScriptを使って取得します。複数のActiveGateがある場合は、重複するバージョンを取り除いて、最大のものを取り出しています。Workflowのうち、このステップ以外はOneAgentの場合と同様です。
このように、Workflowを使うと痒い所に手が届く便利なスクリプトを作ることができ、自動化することでより安定的な運用につながります。ぜひお試しください。
Dynatraceフリートライアル → https://www.dynatrace.com/ja/trial/