Go Agentセットアップガイド

Go Agentはゲームサーバーへ接続できるマシンで動き、Monetaから処理を取得してRCONコマンドを送信します。1つのAgentで複数の送信先を扱えます。Discordロールだけの商品には不要です。

導入条件

管理画面から取得できる設定済みZIPはWindows 64bit用です。ゲーム側のRCONポート・パスワードと、ゲーム・プラグインの条件を確認します。別OSでの導入は環境を添えて問い合わせ窓口へ相談してください。

起動ファイルを失くした・認証キーを更新したい

Agent詳細の「設定済みZIPを再発行」から進みます。再発行すると古い認証キーは無効になります。新しいZIPを保存し、稼働中のAgentにも新しい設定を適用してください。

登録・再発行画面を閉じた後に、同じ秘密鍵をもう一度取り出すことはできません。ダウンロードに失敗した場合は、その画面を閉じずに再試行します。

Agentの更新・再起動

Agentを停止してから実行ファイルを更新し、既存の config.json と cache を維持して再起動します。再発行した場合は新しい設定を適用します。状態ファイルを削除して処理をやり直させないでください。実行中断の記録がある状態で旧版へ戻さないでください。

Agentを無効化すると新たな通信は拒否されますが、すでに配信したコマンドは停止できません。結果不明の処理はゲーム側の状態を確認してから対応します。

設定ファイル

登録時に取得したAgent専用の設定を使います。個別に保存する場合は、登録・再発行画面の「設定ファイルを個別に保存する場合」を開き、コピー操作を使います。

設定ファイルは共有せず保管します。RCON接続先とパスワードはMoneta管理画面で設定し、設定済みZIPにはRCONパスワードを含めません。

Windowsの通常起動では、実行ファイルと同じフォルダーの config.json、config.yaml、config.yml の順に探します。相対指定の cache とログも同じフォルダーが基準です。以前の start-agent.bat から更新しても、設定と状態ファイルを同じ場所で使います。

別の設定ファイルを使う場合は、環境変数 MONETA_AGENT_CONFIG で指定できます。この指定があるサービス・タスクからの起動では、呼び出し元の作業フォルダーを基準にします。更新時に設定の指定や作業フォルダーを変更しないでください。Linux・macOSの起動方法は変わりません。

バージョンとログ

展開先のフォルダーでPowerShellを開き、次のコマンドでバージョンを確認できます。

.\moneta-agent.exe --version

標準では起動画面にJSON形式・info レベルのログが表示されます。起動時のエラー、Agent ID、処理番号、時刻をMonetaの処理履歴と照合してください。ログを相談先へ渡す場合は、認証情報や不要なプレイヤー情報を伏せます。

ダブルクリックで開いたAgentがエラー終了した場合は、表示された内容を確認してEnterキーで閉じます。既存のターミナルからの実行、入出力をリダイレクトした実行、--version は入力待ちになりません。

ファイルへ保存する場合は、既存設定の他の項目を残して、次の logging を追加します。

{
  "logging": {
    "level": "info",
    "format": "json",
    "output": "file",
    "file": "./agent.log"
  }
}

書き込み可能な場所を指定し、設定変更後はAgentを再起動します。ログは追記されるため、ファイルの容量を確認し、保存期間を決めて管理してください。

停止と再起動

起動中のコンソールでCtrl+Cを押し、Agentの停止が終わるまで待ちます。再開するときは同じ展開先から起動します。ウィンドウを閉じたり強制終了した場合はコマンド実行が中断される可能性があるため、次回起動時のログを確認してください。

状態ファイルを保全する

標準の cache フォルダーには、idempotency_cache.json と result_outbox.json などの実行記録があります。重複実行の防止と、結果を報告し終えるまでの保管に使います。処理の復旧のために削除するファイルではありません。

cacheや実行状態を復元できないエラーで停止した場合は、ファイルを残し、フォルダーの権限・ディスクの状態・ゲーム内の結果を確認します。ファイルを削除したり、空のフォルダーで同じAgentを起動しないでください。特典が反映されない場合の手順に従い、結果が分からない場合は問い合わせます。

接続後は商品設定と反映確認へ進みます。