ArchyntArchynt.api
ドキュメント

Archyntの仕組み

ひとつのグラフ、8つの機能 — 静的解析からライブトポロジー、ログ、カスタムメトリクスダッシュボード、アラート、AIによるインサイト、自動PRチェック、そしてパブリックリポジトリ向けの無料GitHub Actionまで。

静的解析

プロジェクト

任意のコードベースを生きたアーキテクチャとして理解できます。ArchyntはJava、Node、Python、Goを解析し、自動的にグラフを構築します。

プロジェクトについて学ぶ
ライブトポロジー

ランタイム

読み取り専用のエージェントが計装なしでサービス、依存関係、ホストの負荷状況をライブで検出します。現在はDocker、Kubernetesとsystemdは次に予定されています。

ランタイムについて学ぶ
メトリクスとダッシュボード

メトリクス

Prometheusメトリクスを使って、自由記述のPromQL、しきい値、組織単位のパネルでGrafanaライクなダッシュボードを構築できます。

メトリクスについて学ぶ
AI分析

AIインサイト

LLMがアーキテクチャグラフ(静的またはライブ)を推論し、結合度の問題やgod-serviceを検出して、根拠と具体的な解決策とともに提示します。

AIインサイトについて学ぶ
ライブログ

ログ

コンテナのログをDockerから直接読み取り、時間範囲とレベルで絞り込み、検索とライブテールが可能です — 保守すべきログ転送パイプラインは不要です。

ログについて学ぶ
アラート

アラート

CPUスパイク、RAM逼迫、エラー率の異常、コンテナ停止が自動的にアラートを発生させます — チームにメールで通知され、しきい値の設定は不要です。

アラートについて学ぶ
GitHub連携

PRチェック

すべてのプルリクエストがmainと比較して分析され、GitHubにチェックランとして公開されます — 新しい設計上の問題があればマージ前にチェックが失敗します。

PRチェックについて学ぶ
パブリックリポジトリは無料

GitHub Action

任意のパブリックリポジトリにワークフローを追加するだけで、すべてのPRで同じアーキテクチャチェックが得られます — Archyntのアカウントもトークン共有も不要です。

GitHub Actionについて学ぶ

よくある質問

ArchyntはDatadog、Grafana、Dynatraceと何が違うのですか?

これらのプラットフォームはテレメトリ(メトリクス、ログ、トレース)から「今何が起きているか」に答えます。Archyntは別の問いに答えます:「実際に稼働しているシステムは、コードが記述している通りか?」ソースコードを構造的なグラフとして解析し、読み取り専用のランタイムエージェントと相関させ、各依存関係を静的、ランタイム、または両方としてラベル付けします。Archyntはチームがすでに持っているPrometheusメトリクスを取り込んでそのグラフを強化することもできますが、テレメトリの保存で競合するものではありません — 価値の単位はダッシュボードではなく、アーキテクチャグラフとそれに基づく推論そのものです。

Archyntは私のソースコードを見るのですか?

静的解析はリポジトリを解析してクラス、モジュール、エンドポイントとその関係をグラフとして抽出します — コードのテキスト自体を第三者に送信して保存することはありません。ランタイムエージェントは読み取り専用で、観測対象のシステムに何かを変更したり実行したりすることは一切ありません。

アーキテクチャドリフトとは何ですか?

ドリフトとは、一方の層には存在するがもう一方には存在しない依存関係のことです: 実際のトラフィックで観測されたサービス間呼び出しでありながらコードのどのパスにも文書化されていないもの、あるいはコードに宣言されているのにランタイムで実際には一度も実行されない依存関係(デッドコードの候補)です。Archyntが各エッジに付与するconfirmed_byラベル — 静的、ランタイム、または両方 — があるからこそ、そもそもドリフトを検出できるのです。

Archyntはどの言語・フレームワークを解析しますか?

現在はJava/Spring、Node/NestJS、Python、Goに対応しており、それぞれ言語専用のワーカーが同一のグラフモデルの背後で動作します。同じワーカー契約を拡張することで、対応言語を追加していきます。

アプリケーションを計装する必要はありますか?

いいえ。ランタイムエージェントはDocker APIと/procからサービス、コンテナ、依存関係をライブで検出します — SDKもサイドカーもコード変更も不要です。RED指標(rate、errors、duration)はeBPFセンサー(Beyla)から得られ、こちらもアプリケーションのコードには一切触れません。

コーディング用のAIエージェントはArchyntを直接使えますか?

はい。ArchyntはMCPサーバーを公開しており、CursorやClaude Codeのようなツールが実際のアーキテクチャグラフを照会したり、未解決の設計上の問題を一覧したり、コード生成前に提案された変更がアーキテクチャ上の境界を越えるかどうかを検証したりできます。機械可読な説明は/llms.txtと/.well-known/mcp.jsonをご覧ください。

Archyntはプルリクエストを自動でレビューしますか?

はい。リポジトリにGitHub Appをインストールすると、すべてのプルリクエストがチェックをトリガーします: Archyntはベースコミットとヘッドコミットの両方についてアーキテクチャグラフを構築し、両者の間の設計上の問題を比較します。PRがHIGHの深刻度を持つ新しい問題を導入するとチェックは失敗し、結果(導入または解決された問題を含む)はGitHubのネイティブなチェックランとして公開されます。このチェックは決定的で、Archyntの他の部分と同じ検出器を使用しており、LLMの呼び出しではありません。

試してみる準備はできましたか?

最初の分析を実行するか、組織のワークスペースに入ってください。