【Box】一括アップロードで困った時の監査ログで原因を確認する方法

Boxで複数のファイルを一括アップロードしようとした際に、途中で失敗したり、一部のファイルだけがアップロードされないといったトラブルは珍しくありません。特に会社の業務で利用している場合、原因がすぐに分からずに作業が止まってしまうと焦ってしまうものです。この記事では、一括アップロードで問題が発生したときに、Boxの監査ログを使って原因を特定する方法を詳しく解説します。監査ログを活用することで、権限設定やファイル制限、システムエラーなど、どのレイヤーで問題が起きたのかを切り分けられます。

1. 一括アップロードで発生しやすいトラブルの種類

一括アップロードの失敗は、大きく分けて3つのカテゴリに分類できます。1つ目はファイル個別の制限に引っかかるケースです。Boxでは1ファイルあたりの最大サイズ(通常は15GB、管理者が変更可能)、ファイル名の長さ(255文字まで)、特殊文字の使用などに制限があります。2つ目はアクセス権限の問題です。アップロード先のフォルダに対して書き込み権限がない場合や、共有設定で外部ユーザーが制限されている場合などです。3つ目はシステムエラーやクライアント側の不具合です。ネットワークの不安定さ、Box SyncやBox Driveの同期エラー、ブラウザのセッション切れなどが原因となります。監査ログはこれらの原因を切り分けるための最初の手がかりを提供します。

2. 監査ログを確認する前に準備すること

監査ログを確認するためには、Box管理コンソールにアクセスできる管理者アカウントが必要です。一般ユーザーは自分の監査ログを直接見ることはできませんので、管理者に依頼するか、自身が管理者権限を持っている場合は以下の手順で準備を進めてください。まず、トラブルが発生した日時とユーザーを正確に把握しておきます。一括アップロードの試行が何時ごろで、どのユーザーが操作したのか、アップロード先のフォルダパスも記録しておきましょう。また、失敗したファイルの名前やサイズ、エラーメッセージがあればスクリーンショットを取得しておくと、監査ログの検索に役立ちます。

さらに、Box管理コンソールの監査ログには大量のイベントが記録されるため、あらかじめフィルタ条件を決めておくことが重要です。特に「イベントタイプ」で「アップロード」や「アクセス拒否」、「ファイルアップロード失敗」を選択すると、目的のログを絞り込みやすくなります。日時範囲はトラブル発生時刻の前後30分程度に設定すると、周辺のログも含めて確認できます。

3. 監査ログで実際に原因を特定する手順

では、実際に監査ログを使って原因を特定する手順を説明します。以下の操作は、Box管理コンソールの「監査ログ」タブで行います。ステップごとに進めてください。

1. Box管理コンソールに管理者アカウントでログインし、左メニューから「監査ログ」をクリックします。
2. 表示されたイベントビューアの上部で、日時範囲を設定します。デフォルトは過去24時間ですが、トラブルの発生時刻が分かっている場合はその前後30分に絞ります。
3. 「フィルターの追加」をクリックし、「イベントタイプ」を選択します。アップロード失敗を確認するなら「ファイルアップロード失敗」を選びます。ほかに「アクセス拒否」「ファイルアップロード」なども組み合わせて設定できます。
4. 必要に応じて「ユーザー」フィルターで該当ユーザーを指定します。トラブルを起こしたユーザーが分かっている場合は、そのメールアドレスを入力して絞り込みます。
5. 「フォルダ」フィルターでアップロード先のフォルダIDを指定することもできます。フォルダIDはフォルダを開いたときのURL末尾の数字です(例: https://app.box.com/folder/1234567890)。
6. フィルター適用後、イベント一覧が表示されます。該当のイベントをクリックすると詳細が表示され、拒否理由やエラーコードが確認できます。例えば「access_denied」と表示されれば権限不足、「file_size_limit_exceeded」ならファイルサイズ制限超過です。
7. 詳細情報の中に「IPアドレス」「ユーザーエージェント」「リクエストID」なども含まれているため、必要に応じてメモしておきます。

以上の手順で、どのファイルがなぜアップロードできなかったのかを特定できます。複数のファイルが失敗している場合は、各イベントを順に確認してください。

4. 監査ログに表示される代表的なエラーとその対処法

監査ログで確認できるエラーメッセージは多岐にわたりますが、代表的なものを以下の表にまとめました。エラーコードとその意味、考えられる原因、対処法を一覧で確認できます。

エラーコード(監査ログ表示)	意味	主な原因	対処法
access_denied	アクセス拒否	フォルダへの書き込み権限がない、または共有リンクの設定でアップロードが禁止されている	フォルダの権限設定を管理者に確認し、適切な権限(編集者以上)を付与してもらう
file_size_limit_exceeded	ファイルサイズ制限超過	アップロードしようとしたファイルがBoxのファイルサイズ上限(デフォルト15GB)を超えている	ファイルを分割するか、管理者に上限変更を依頼する(ただしセキュリティポリシーによる)
folder_size_limit_exceeded	フォルダサイズ制限超過	アップロード先フォルダが容量制限(管理者設定)に達している	フォルダ内の不要ファイルを削除するか、管理者に容量上限の引き上げを依頼する
quota_exceeded	ユーザーストレージ容量超過	ユーザーのBoxストレージ割り当て(クォータ)を超えている	不要ファイルを削除するか、管理者にクォータ増加を依頼する
file_name_invalid	ファイル名無効	ファイル名に使用できない文字(< > : ” / \ | ? *)が含まれているか、255文字を超えている	ファイル名を修正して再アップロードする

これらのエラーは監査ログの詳細画面で確認できます。エラーコードが直接表示されない場合でも、説明文から原因を推測できます。

4.1 監査ログに記録されないケースとその対処

まれに、監査ログにエラーが記録されないままアップロードが失敗することがあります。例えば、ブラウザがクラッシュした、ネットワークが途中で切断された、Box Syncの同期エンジンが応答しなくなったなど、クライアント側の要因が大きい場合は、サーバーにイベントが届かないことがあります。このような場合、監査ログだけでは原因が特定できません。クライアントログ(例えばBox Syncのログファイル)やブラウザの開発者ツール(コンソールログ)を確認する必要があります。また、Box Driveの場合はシステムトレイアイコンから「診断情報をエクスポート」を実行すると詳細なログが得られます。これらの手順はやや専門的ですが、管理者がサポートに問い合わせる際に役立ちます。

5. 失敗パターン別:よくあるシナリオと監査ログの読み解き方

実際の業務で起こりやすいシナリオをいくつか挙げ、監査ログでどのように見つけるかを説明します。

5.1 権限不足で一部のファイルだけアップロードできない

例えば、同じフォルダに複数ファイルをドラッグ&ドロップしたが、一部だけエラーになった場合です。監査ログで「access_denied」イベントが該当ファイルに対して記録されていれば、そのファイルの保存先フォルダに権限がない可能性があります。実際には、親フォルダには権限があっても、サブフォルダに個別の権限設定がされているケースがあります。監査ログの「フォルダID」を確認し、対象のフォルダの共有設定を管理者に依頼して見直しましょう。

5.2 ファイルサイズ制限に引っかかって一括アップロードが中断する

大容量ファイル(例えば4GB以上の動画)を含む一括アップロードが途中で止まった場合、監査ログに「file_size_limit_exceeded」が記録されることがあります。このエラーは個別のファイルごとに記録されるため、どのファイルが原因で全体が中断したのかが分かります。Boxの一括アップロードでは、上限を超えるファイルがあるとそのファイルだけスキップされる場合と、アップロード全体が失敗する場合があります。監査ログを確認すればどちらの動作になったかも把握できます。

5.3 フォルダの容量制限でアップロードできない

チームで共有しているフォルダの容量が上限に達していると、そのフォルダに新しくファイルを追加できません。監査ログでは「folder_size_limit_exceeded」というイベントが発生します。この場合、フォルダの所有者または管理者が容量を増やすか、不要ファイルを削除する必要があります。監査ログから該当フォルダのIDを特定し、管理コンソールのフォルダ設定で現在の使用量と上限を確認できます。

6. 管理者に依頼すべき情報と連絡のポイント

一般ユーザーが監査ログを直接見られない場合は、管理者に調査を依頼することになります。その際、以下の情報を伝えると問題解決がスムーズです。

• トラブル発生の日時(できるだけ正確に、タイムゾーンも含む)
• 自分のBoxアカウントのメールアドレス
• アップロード先のフォルダ名またはフォルダID(URLから取得)
• 失敗したファイル名(複数ある場合はリスト)とファイルサイズ
• 表示されたエラーメッセージ(スクリーンショットがあればなお良い)
• 使用したクライアント(ブラウザ、Box Sync、Box Driveなど)

管理者はこれらの情報をもとに監査ログを検索し、原因を特定できます。また、管理者自身が監査ログを確認する手順を知らない場合もあるため、この記事の手順を共有すると役立ちます。

7. よくある質問(FAQ)

一括アップロードと監査ログに関するよくある質問をまとめました。

Q1. 監査ログはどのくらいの期間保存されますか?
Boxのエディションにより異なります。Enterpriseプランでは標準で1年間、無料プランでは90日間保存されます。詳細はBoxのドキュメントでご確認ください。

Q2. 監査ログを自分で見るにはどうすればいいですか?
Boxでは一般ユーザーが自身の監査ログを直接参照することはできません。管理者に問い合わせるか、管理者権限を付与してもらう必要があります。ただし、管理者権限は通常、IT部門など限られた担当者にしか付与されません。

Q3. 監査ログにエラーが出ていないのにアップロードが失敗するのはなぜですか?
クライアント側のネットワーク問題やBox Sync/Box Driveの同期エラーなど、サーバーに到達しないエラーの場合、監査ログに記録されません。その場合は、ブラウザの開発者ツールやBox Syncのログファイルを確認する必要があります。

Q4. 一括アップロードの際に、ファイル名に使えない文字はありますか?
Boxでは次の文字が使用できません:< > : ” / \ | ? *。また、ファイル名の長さは255文字までです。これらの制限に違反すると「file_name_invalid」エラーが発生します。

Q5. 監査ログで「ファイルアップロード失敗」イベントが見つかりません。
時間範囲やフィルタを見直してください。また、アップロードがまったく開始されていない場合(例えば、ドラッグ&ドロップすら受け付けない場合)は、イベント自体が生成されないこともあります。その場合、クライアントの状態を確認してください。

まとめ

一括アップロードで問題が発生した場合は、まずBoxの監査ログを確認することで、多くの原因を特定できます。監査ログにはアップロードの成功・失敗、エラーコード、権限情報などが記録されており、権限不足やファイル制限、システムエラーを切り分ける強力な手がかりとなります。監査ログを確認するには管理者権限が必要ですが、一般ユーザーでも管理者に適切な情報を伝えることで迅速な解決につなげられます。日頃からトラブルの再現手順やエラーメッセージを記録しておく習慣をつけると、問題解決がよりスムーズになるでしょう。本記事が、Boxでの一括アップロードトラブル解決の一助となれば幸いです。