Where Them Logs

wherethemlogs.app

Windows、macOS、Linux におけるアプリケーションのログファイル保存場所を検索できるインデックスです。 すべてのパスはインストーラーの種類とアーキテクチャ別に分類され、マシンが書き出すとおりに正確に表示されます。

インシデント対応中にパスが必要になる人のために作られました。IT 管理者やエンドポイント管理者、アプリケーションのパッケージ作成者、そしていつのものかも分からないフォーラムのスレッドを調べるのに20分を費やしたことがある方が対象です。

構成

app/                  pages, route handlers, proxy - Next.js 16
components/  lib/     UI, shared model, server-only data access
infra/                Azure resources - Bicep
scripts/              seed data and the seeder
docs/                 architecture, API reference, deployment, MCP, answer engines

アプリケーションは1つ、イメージは1つです。ページは Cosmos からサーバー側でレンダリングされます。 app/api/ 配下のルートハンドラーが、同じプロセスからブラウザーと管理ポータルにサービスを提供します。

実行方法

npm install
LOCAL_ADMIN_BYPASS=true \
COSMOS_ENDPOINT=https://<account>.documents.azure.com:443/ \
COSMOS_DATABASE=wtla \
npm run dev            # http://localhost:3777

Cosmos のデータプレーンロールを持つアカウントで az login を実行する必要があります。 セットアップの詳細は docs/DEPLOYMENT.md をご覧ください。

内容

ルート	機能
/	タイトル、入力中に候補が表示される検索フィールド、最近追加された項目、最近の検索、プラットフォームフィルター
/search	プラットフォーム、インストーラー、アーキテクチャ、スコープでフィルターできる検索結果一覧
/privacy	プライバシーと Cookie に関する通知
/admin	ベンダー、アプリ、ログパスを管理するポータル。/admin/import で JSON をインポートおよびエクスポートできます。Entra サインインと admin ロールが必要です。API は docs/API.md をご覧ください。

キーボード操作：/ キーでどこからでも検索フィールドにフォーカスし、矢印キーで入力中の候補を移動します。Enter キーで検索結果一覧を表示し、Shift+Enter キーで選択中の結果の最初のパスをコピーします。

カタログ

Vendor > App > LogPath。1つのベンダーに複数のアプリがあり、1つのアプリに複数のログパスがあります。ログパスはアプリのドキュメントに埋め込まれています。すべてのベンダーにアイコンがあり、アプリごとに上書きできます。App.iconUrl: null はベンダーのアイコンを継承することを意味し、読み込み時に解決されます。

現在はシードデータです。24のベンダー、33のアプリ、86のログパスが scripts/seed-data.json に含まれています。すべて実在し、検証可能なもので、フッターとプライバシーページでデモ用データセットとして表示されています。

npm run seed -- --endpoint https://<account>.documents.azure.com:443/

パスはバイト単位でそのまま保存されます。修復対象のマシンはこのマシンではないため、%LOCALAPPDATA%、~/Library/Logs、$XDG_STATE_HOME は展開されません。

項目の投稿

イシューを作成してください。1つのアプリケーションにつき1件とし、タイトルにプラットフォームとインストーラーの種類を記載して、パスの確認方法を説明してください。

イシューは公開されます。実際のホスト名、ユーザー名、テナント識別子、顧客名は投稿しないでください。

公開前の準備

• Entra ID アプリを登録し、admin アプリロールを追加して、リポジトリ変数 AUTH_CLIENT_ID / AUTH_TENANT_ID を設定します。それまでは /admin の接続先がありません。docs/DEPLOYMENT.md § 7。
• 分析プロバイダーを選択します。Google Analytics 4 は Accept の後にのみ読み込まれます（components/Consent.tsx）。
• シードカタログを実際のインデックスに置き換えます。調査結果の JSON は /admin/import から取り込めます。
• CRUD API の上に管理 UI を構築します。
• リポジトリを公開します。リクエストや修正は、.github/ISSUE_TEMPLATE/ にあるフォームからイシューとして投稿できます。

インフラストラクチャ

Azure Container Apps がイメージを実行し、その背後で Cosmos DB（サーバーレス）と Blob Storage が稼働します。どちらにもマネージド ID でアクセスするため、キーは一切ありません。デプロイ時には新しいリビジョンが作成されるため、ロールバックは再ビルドではなくトラフィックの切り替えで行えます。

費用は月額約20ドルです。各構成要素の理由と費用については、docs/ARCHITECTURE.md をご覧ください。

デザイン

DESIGN.mdには、構築済みのビジュアルシステムが記録されています。PRODUCT.mdには、プロダクトの実態が記録されています。サイトの各領域に関する方向性の取り決めは、.impeccable/surfaces/にあります。

CSSを変更する前に、次の2つのルールを確認してください。

• 例外なしのフラットな印刷表現。 グラデーション、シャドウ、浮遊するカードは使いません。構造はステンシルの罫線とハザードテープで表現します。ほぼ黒の背景に使うシグナルシアンは、ネオンのような光彩にならないようにしてください。
• 2つの声。 人間に関するものにはArchivoを、パス、コード、数値、フィルター値など、機械に関するものにはSpline Sans Monoを使います。それ以外は使いません。