トラブルシューティング（自動化エラー対処）

概要

rsync失敗・Claude認証・Slack取得・Inbox自動整理のよくあるエラーと対処。本番環境のトラブルを即時対応。

要点

• よくあるエラーパターンの一覧
• 即時対応コマンドが書かれている
• 原因の切り分けフロー

対象読者

• 運用担当
• IT管理者

効果

トラブル対応時間を90%削減。

Vault本文より抜粋

---

観点	一言
核心	自動化システムでエラーが起きた時の対処法。
キーワード	通知システム / よくあるエラーと対処 / ヘルスチェックコマンド
使う人	全社員 / 運用担当
読了目安	5-7分
自動化システムでエラーが起きた時の対処法。
エラーが起きたら以下に届きます：
1. macOS通知センター（即時、画面右上）
2. Slack #scale-ai-all チャンネル（履歴として残る、エラー時のみ）
3. ~/Obsidian/logs/notifications.log（全履歴）
症状:
```
rsync(xxxx): error: 90_Meta/<ファイル名>.md: mmap: Resource deadlock avoided
rsync(xxxx): error: rsync_downloader / rsync_receiver
[ERROR] sync failed with exit code 1
```
> 通知の「TCC権限要確認」は固定文字列で、真因とは限らない
> 必ず tail -30 ~/Obsidian/logs/sync.log で実際のエラーを確認すること。
原因:
- macOS の Google Drive for Desktop（CloudStorage プロバイダ）は仮想FSで、rsync が whole-file mmap で書き込もうとすると Drive側の同期ロックと deadlock する

フル本文を開く

• Obsidianで開く: obsidian://open?vault=SCALE-Brain&file=90_Meta%2F%E3%83%88%E3%83%A9%E3%83%96%E3%83%AB%E3%82%B7%E3%83%A5%E3%83%BC%E3%83%86%E3%82%A3%E3%83%B3%E3%82%B0
• Vault パス: 90_Meta/トラブルシューティング.md

このノートは Vault が正本。最新の編集は Obsidian 側で行うこと。