> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# ロギング

> 148 種類のサーバーイベントを Discord チャンネルまたは Webhook に記録します。各イベントで独自のチャンネルと色を設定可能。

ロギングは事後に「実際に何が起きたか」に答えます。Vetox は **148 種類のイベント** を、それぞれ独立して設定して記録できます。

<Info>
  ロギング自体は無料です。実行者の表示、Webhook 投稿、一括セットアップツールの 3 つのオプションは **Basic** が必要です。
</Info>

## 画面

**All** に加えて 14 のカテゴリータブがあり、各タブに有効化されたイベント数が表示されます。すべてのタブに検索ボックスと有効イベントのランニングカウントがあります。

<CardGroup cols={3}>
  <Card title="Server" icon="server" />

  <Card title="Moderation" icon="gavel" />

  <Card title="Messages" icon="message" />

  <Card title="Channels" icon="hashtag" />

  <Card title="Roles" icon="user-tag" />

  <Card title="Emote Zone" icon="face-smile" />

  <Card title="Voice" icon="microphone" />

  <Card title="Threads" icon="comments" />

  <Card title="Events" icon="calendar" />

  <Card title="AutoMod" icon="filter" />

  <Card title="Stage" icon="podium" />

  <Card title="Webhooks" icon="link" />

  <Card title="Integrations" icon="plug" />

  <Card title="Giveaways" icon="gift" />
</CardGroup>

<Warning>
  **4 つの Battle Pass ログイベントにはカテゴリーがありません。** Tier unlocked、Season started、Season ended、Quest completed は存在して動作しますが、**All** タブからのみ到達可能です ― どのカテゴリータブにも含まれません。

  他にもいくつか、翻訳された名前なしで表示されるイベントがあります。
</Warning>

## イベントの設定

各イベントは **既定でオフ** で、独自の設定を持ちます。

| 設定                    | 既定    | 備考                                            |
| --------------------- | ----- | --------------------------------------------- |
| **Enabled**           | オフ    |                                               |
| **Destination**       | チャンネル | チャンネルと Webhook を切り替え                          |
| **Log Channel**       | なし    | 投稿先                                           |
| **Webhook URL**       | なし    | Discord の Webhook URL でなければならない。**Basic プラン** |
| **Log Color**         | 既定の青  | 任意の 16 進カラー                                   |
| **Disabled Channels** | なし    | 特定チャンネルを除外。**メッセージ系 9 イベントでのみ利用可**            |
| **Show Executor**     | オフ    | 実行者を含める。**Basic プラン**                         |

<Warning>
  **チャンネルと Webhook は排他です。** 一方を設定するともう一方はクリアされます。同じイベントを両方に送ることはできません。
</Warning>

<Warning>
  Starter では、**Show Executor** と **Webhook URL** は **保存時に静かにリセット** されます ― エラーも警告もなく、値がそのまま元に戻ります。

  これら 2 つが定着しないのはそのためです。イベントのその他は通常通り保存されます。
</Warning>

<Note>
  **Disabled Channels** の除外はメッセージイベントにのみ存在します。ボイス、ロール、モデレーションイベントにはチャンネル別除外はありません。
</Note>

## 多数のイベントを一括で設定

148 個を個別に設定するのは現実的でないため、**Manage Logs** がチャンネル作成とイベント接続を一括で行います。**Basic** が必要です。

| モード                     | 結果                           |
| ----------------------- | ---------------------------- |
| **Individual Channels** | イベントごとに別チャンネル                |
| **Category**            | Logs カテゴリー配下にカテゴリーごと 1 チャンネル |

作成されたチャンネルを閲覧できるロールと、除外するチャンネルも選べます。作成チャンネルは `@everyone` を拒否し、指定したロールにのみ権限を付与します。

ダイアログはチャンネル作成、ログ割り当て、権限設定、例外適用の進捗をレポートします。

<Tip>
  **Category モードがほぼ常に正解です。** 広範な選択で Individual モードを使うと、非常に多くのチャンネル（最大 148）が作成されます。
</Tip>

## 保存

実際に変更したイベントのみが送信されるので、1 つのトグルを保存しても全設定が書き換わることはありません。

<Note>
  [Dashboard Watcher](/ja/server-management/dashboard-watcher) が記録するのは、ロギングでは **有効化・無効化アクションのみ** です。チャンネル、Webhook、色の変更は正しく保存されますが、監査エントリーは残りません。
</Note>

## 何をログするか

<AccordionGroup>
  <Accordion title="モデレーションとサーバーイベントから始める" icon="star">
    これらは実際に読み返すことになるものです。
  </Accordion>

  <Accordion title="メッセージイベントは大量" icon="triangle-exclamation">
    活発なサーバーでの編集・削除ログは膨大です。最も賑わうチャンネルを Disabled Channels で除外してください ― 除外できるのはこのカテゴリーだけです。
  </Accordion>

  <Accordion title="ボイスイベントは見た目より騒がしい" icon="volume-high">
    ボイスの入退出は絶え間なくエントリーを生みます。本当に必要な場合のみログしてください。
  </Accordion>

  <Accordion title="Webhook はチャンネル変更を乗り越える" icon="link">
    Webhook 送信先はチャンネル名変更や移動があっても機能し続け、そこでボットに送信権限がなくても投稿できます。Basic が必要です。
  </Accordion>
</AccordionGroup>

## トラブルシューティング

<AccordionGroup>
  <Accordion title="何もログされない">
    [サーバーセットアップ](/ja/server-management/setup) でロギングがオンか、次に該当イベントが有効で送信先が設定されているかを確認してください。
  </Accordion>

  <Accordion title="Show Executor が自動でオフに戻る">
    Basic が必要で、それ未満のプランでは静かにリセットされます。
  </Accordion>

  <Accordion title="Webhook を設定したのにチャンネルに戻った">
    同じ原因です ― Webhook 送信先には Basic が必要です。
  </Accordion>

  <Accordion title="Battle Pass のログイベントが見つからない">
    カテゴリータブがありません。All タブで検索してください。
  </Accordion>

  <Accordion title="イベント名が空か奇妙">
    ごく少数のイベントは表示名なしで出荷されます。イベント自体は通常通り動きます。
  </Accordion>
</AccordionGroup>

## 関連

<CardGroup cols={2}>
  <Card title="Dashboard Watcher" icon="desktop" href="/ja/server-management/dashboard-watcher">
    Discord ではなくダッシュボードで行われた変更を追跡。
  </Card>

  <Card title="モデレーションツール" icon="gavel" href="/ja/moderation/moderation-tools">
    現在有効な処罰を確認・解除。
  </Card>
</CardGroup>