Skip to Content

稼働状況の確認

前提条件の確認

Blockfrost プラットフォームの稼働状況を確認する前に、以下の重要な設定が正しいことを確認してください。

稼働中の Cardano ノード

パブリック IP アドレスを持つメインネット (本番) cardano-node インスタンスが稼働していること。

NFT アドレスの設定

重要: Icebreaker NFT を保有する正確なアドレスを使用してください。一般的なウォレットアドレスではありません。

init コマンドを実行するか手動で設定する際、NFT を保有する固有のアドレスを使用します。

--reward-address addr1xxx...  # NFT を保有するアドレス。一般的なウォレットアドレスではありません

ウォレットは通常複数のアドレスを保持しています。 プラットフォームは特に NFT が存在するアドレスを必要とします。 ウォレットを確認して、どのアドレスが Icebreaker NFT を保有しているかを特定してください。

ネットワークポートの設定

必要なポートが正しく開放されていることを確認してください。 Blockfrost プラットフォームのデフォルトポートは 3000 です。

クラウドホスティングの場合

  • Azure: ポート 3000 のトラフィックを許可する新しい送信ルールを作成

  • AWS: セキュリティグループを設定してポート 3000 のトラフィックを許可

  • その他のプロバイダー: ファイアウォール設定を適宜更新

サービスの基本確認

前提条件を確認したら、サービス自体を確認します。

インストールの確認

ソフトウェアが正しくインストールされていることを確認します。

blockfrost-platform --version

現在のバージョン番号が表示されるはずです。

サービス起動の確認

サービスを起動し、正常に初期化されたか確認します。

blockfrost-platform --node-socket-path /path/to/node.socket \
                    --secret your_icebreaker_secret \
                    --reward-address your_nft_address

ログに初期化メッセージが表示されるはずです。 DEBUG: Decoding done というメッセージが表示されれば正常動作しています。

このメッセージが表示されない、またはエラーが出る場合は次を確認してください。

  • ノードソケットパスのアクセス可能性
  • シークレットキーの正当性

稼働確認

サービスが起動したら、正しく機能しているか確認します。

UUID の理解

非ソリタリーモードで動作する場合、Blockfrost プラットフォームは起動のたびに新しい UUID を生成します。 この UUID は Icebreakers ロードバランサー経由のリクエストルーティングのプレフィックスとして使用されます。

UUID を含むログエントリの例

INFO: Your instance ID: 3fa85f64-5717-4562-b3fc-2c963f66afa6
                        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

手動でのトランザクション送信テストなどではこの UUID が必要になります。 それ以外では、実装上の詳細とお考えください。 ソリタリーモードでは UUID は生成されません。 サービスを再起動するたびにこの値が変わることを覚えておいてください。

メトリクスエンドポイントの確認

サービスが正しくメトリクスを報告しているか確認します。

wget http://your-server-ip:3000/metrics

正常に動作している場合、このエンドポイントは以下を提供します。

  • 提供された API コール数
  • リソース使用統計
  • 稼働時間情報

注: メトリクスエンドポイントには最新バイナリが必要な場合があります。 500 エラーが返る場合はインストールを更新してください。

ヘルスエンドポイントの確認

ヘルスエンドポイントを呼び出してサービスの稼働状況を確認します。

wget http://your-server-ip:3000/

正常に動作している場合、このエンドポイントは以下のようなサービスステータスを含む JSON を返します。

  • アプリケーション名
  • 現在のリリースバージョン
  • リビジョン (Git コミットハッシュ)
  • 全体的な稼働状況を示すブール値 (healthy)
  • ブロック、エポック、時代、スロット、同期進捗の情報
  • 検出された問題の配列

healthy が true であればサービスは正常です。 503 エラーが返るか healthy が false の場合は、ログを確認するか、インストールを更新して潜在的な問題を解決してください。

Icebreaker ダッシュボードでのモニタリング

ノードのステータスを視覚的に確認するには、Icebreaker ダッシュボード https://icebreakers.blockfrost.io/  にアクセスしてください。

あなたのノードは ‘Icebreaker X’ として表示され、X は割り当てられた番号 (NFT メタデータで確認可能) です。

このダッシュボードでは以下を確認できます。

  • 接続状態
  • パフォーマンス指標
  • 他の Icebreaker ノードとの比較

よくあるトラブルシューティング

確認に失敗する場合、以下のよくある問題を確認してください。

‘Decoding done’ メッセージが表示されない

  • Cardano ノードが完全に同期されているか確認
  • ノードソケットパスのアクセス可能性を確認

メトリクスエンドポイントにアクセスできない

  • ネットワークからポート 3000 にアクセスできるか確認
  • メトリクスが無効化されていないか確認 (--no-metrics フラグまたは設定)

負荷時に 503 エラーが返る

  • サーバーには同時接続数の上限があります (デフォルト: 8192)。上限を超えるリクエストは 503 を受け取ります。
  • 必要に応じて --server-concurrency-limit で上限を引き上げてください。

Grafana に表示されない

  • ノードが表示されるまで最大 10 分待つ
  • NFT アドレスが正しく設定されているか確認
  • ファイアウォールが送信接続を許可しているか確認
Last updated on
ユースケース