【Box】CADファイルの表示で困った時の監査ログで原因を確認する方法

Box上でCADファイルを開こうとしたとき、突然のエラーやプレビューが表示されずに困った経験はありませんか。特に会社の共有フォルダに保存された図面や設計データが突然見られなくなると、業務に大きな支障が出ます。そうした問題の原因を突き止めるために、Boxが提供する「監査ログ」が非常に役立ちます。監査ログには、いつ誰がどのファイルにアクセスし、どのような操作をしたかが詳細に記録されています。本記事では、CADファイルの表示トラブルが発生した際に、監査ログを活用して原因を特定する方法を具体的に解説します。

Box監査ログとは何か

Boxの監査ログは、Box上で発生したすべての操作を時系列で記録したものです。ファイルのアップロード、ダウンロード、プレビュー、削除、共有設定の変更、ユーザーのログインなど、多岐にわたるイベントが取得されます。監査ログにアクセスできるのはBox管理コンソールの「レポート」→「監査ログ」からですが、管理者権限を持つユーザーに限定されます。ログはCSV形式でエクスポート可能で、Excelなどでフィルターや検索を行うことで特定のファイルやユーザーの操作を抽出できます。

CADファイルの表示トラブルに関連する主なイベントとしては、「ファイルのプレビュー失敗」「ファイルのダウンロード失敗」「ファイルのアップロード失敗」などがあります。これらのイベントは通常「FAILED」というステータスで記録され、エラーの種類(例:UNSUPPORTED_FILE_TYPE)も含まれます。この情報をもとに、問題がファイル自体にあるのか、権限にあるのかを判断できます。

CADファイルの表示に関する主なエラーと原因

Box上でCADファイルを表示しようとしたときに発生するエラーは、大きく分けて以下の4つに分類できます。

1. ファイル形式がサポートされていない

Boxのプレビュー機能はすべてのCAD形式に対応しているわけではありません。例えば、AutoCADのDWGファイルはプレビュー可能ですが、古いバージョンや特定の機能(3Dモデリングなど)を含むファイルは正しく表示されないことがあります。また、STEPやIGESなどの汎用CAD形式はサポート外の場合があります。監査ログでは「UNSUPPORTED_FILE_TYPE」というエラーコードが記録されます。

2. ファイルサイズが大きすぎる

Boxのプレビュー機能にはファイルサイズの上限があります。例えば、プレビュー可能な最大ファイルサイズは契約プランによって異なりますが、一般的には500MB程度です。CADファイルはしばしば数百MBから数GBになるため、上限を超えるとプレビューが失敗します。監査ログには「FILE_SIZE_EXCEEDS_LIMIT」や「PREVIEW_FAILED」と記録されます。

3. アクセス権限が不足している

ファイル自体が存在していても、そのフォルダやファイルに対する適切な権限がないと表示できません。例えば、共同編集者権限がないユーザーがプレビューしようとすると、404エラーや401エラーが発生します。監査ログでは「ACCESS_DENIED」や「UNAUTHORIZED」というイベントが記録されます。

4. ファイルが破損または不完全

アップロード中にエラーが発生してファイルが破損した場合、プレビューができないことがあります。または、ファイル自体が正しいCADフォーマットであっても、Boxの変換エンジンが処理できない形式の場合もあります。監査ログでは「FILE_CORRUPT」や「CONVERSION_FAILED」が記録されることがあります。

監査ログによる原因確認の具体的な手順

以下に、実際に監査ログを使って問題の原因を特定する手順を示します。管理者としてBox管理コンソールにアクセスできることが前提です。

1. 管理者アカウントでBox管理コンソール(https://app.box.com/master)にログインします。
2. 左側のメニューから「レポート」→「監査ログ」をクリックします。
3. 監査ログ画面で、日付範囲を指定します。問題が発生した日時に絞り込むために、開始日と終了日を設定します。通常は「過去24時間」または「過去7日間」を選択します。
4. さらに絞り込み条件として、「イベントタイプ」から「コンテンツ操作」→「プレビュー失敗」「ダウンロード失敗」「アップロード失敗」などを選択します。「ファイル」に問題のファイル名の一部や拡張子を入力することもできます。
5. 「フィルターを適用」をクリックし、結果を表示します。表示されたログを確認し、該当するイベントの「詳細」をクリックしてエラーコードやメッセージを確認します。
6. 必要に応じて「エクスポート」ボタンからCSVファイルをダウンロードし、Excelで詳細を分析します。CSVにはイベントの日時、ユーザー、ファイル名、操作、結果、エラーコードなどが含まれます。
7. エラーコードをもとに原因を特定します。例えば、エラーコードが「PREVIEW_FAILED」で詳細に「FILE_SIZE_EXCEEDS_LIMIT」とあれば、ファイルサイズの問題です。同様に「UNSUPPORTED_FILE_TYPE」であれば形式の問題です。
8. 原因が特定できたら、対応策を実行します。形式の問題であればファイルを別の形式に変換する、サイズの問題であれば分割してアップロードする、権限の問題であれば共有設定を見直す、といった対応が考えられます。

状況別の比較表

監査ログで確認できるエラーコードと、考えられる原因・対応策を表にまとめました。

状況	監査ログのエラーコード例	主な原因	対応策
CADファイルのプレビューが表示されない	PREVIEW_FAILED, FILE_SIZE_EXCEEDS_LIMIT	ファイルサイズが大きすぎる、またはサポート外の形式	ファイルを分割してアップロードする、またはBoxがサポートする形式(DWG, DXF, PDFなど)に変換する
ファイルをダウンロードしようとするとエラー	DOWNLOAD_FAILED, ACCESS_DENIED	権限不足、またはファイルが破損	権限設定を確認する、ファイルを再アップロードする
ファイル自体が見つからない	FILE_NOT_FOUND, ITEM_DELETED	ファイルが削除された、または移動された	ゴミ箱を確認する、管理者に問い合わせる
特定のユーザーのみ表示できない	UNAUTHORIZED, ACCESS_DENIED	個別のアクセス権限が不足	共有リンクの権限を確認、または直接招待する

失敗パターンと注意点

監査ログを活用する際にありがちな失敗パターンをいくつか紹介します。これらを避けることで、効率的に原因を特定できます。

時間範囲の誤った設定

問題が発生した正確な時刻を把握していないまま、広い範囲でログを取得すると、膨大なログの中から目的のイベントを見つけるのが困難になります。逆に狭すぎるとイベントが含まれていない可能性があります。必ず問題が起きたと思われる時間をできるだけ正確に特定し、その前後30分程度の範囲でフィルタリングしましょう。

イベントタイプの選択ミス

「プレビュー失敗」ではなく「アイテムプレビュー」を選択してしまい、正常なプレビューイベントが多数表示されてしまうことがあります。監査ログには成功したイベントもすべて記録されるため、失敗イベントだけを絞り込むためには「失敗」を含むイベントタイプを正確に選択する必要があります。

権限不足でログが見えない

一般ユーザーは監査ログにアクセスできません。自分が管理者でない場合は、Box管理者に問い合わせてログを確認してもらう必要があります。その際、問題のファイル名、発生時刻、エラーメッセージのスクリーンショットなどを準備しておくとスムーズです。

エラーコードの読み間違い

例えば「PREVIEW_FAILED」というエラーでも、原因はファイルサイズ制限、形式非対応、変換エンジンのバグなど様々です。監査ログの詳細フィールドには具体的な理由が記載されていることが多いので、必ず詳細まで確認しましょう。

よくある質問

ここでは、CADファイルの表示トラブルと監査ログに関するよくある質問をまとめました。

Q1. 監査ログは誰でも見られますか?

いいえ、監査ログを参照できるのはBox管理者権限を持つユーザーのみです。一般ユーザーはアクセスできません。どうしても自分で確認したい場合は、管理者に依頼してください。

Q2. 監査ログの保持期間はどのくらいですか?

Boxのプランによって異なります。無料の個人プランでは数日間、Businessプランでは1年間、Enterpriseプランでは無制限に保存されます。ただし、大量のログはパフォーマンスに影響するため、定期的にエクスポートして保管することを推奨します。

Q3. CADファイルのプレビューで「変換中」と表示されたまま進まないのはなぜですか?

これは、Boxのサーバー側でファイルのプレビュー用の変換処理が行われている状態です。ファイルサイズが大きい場合に発生しやすく、通常は数分で完了しますが、長時間変わらない場合は何らかのエラーが発生している可能性があります。その場合、監査ログで「CONVERSION_FAILED」や「TIMEOUT」といったイベントが記録されていないか確認してください。

Q4. 監査ログで「ITEM_PREVIEW」のイベントは成功しているのに画面に表示されない場合は?

ブラウザやネットワークの問題が考えられます。まずはブラウザのキャッシュをクリアし、シークレットモードで試してみてください。また、Boxでサポートされているブラウザのバージョンであるか確認しましょう。それでも解決しない場合は、Boxのサービスステータスを確認し、障害が発生していないかをチェックします。

Q5. 管理者に依頼するときに伝えるべき情報は?

下記の情報を用意して依頼すると、迅速に調査してもらえます。

• 問題が発生した日時(できるだけ正確に)
• ファイルの名前と格納場所(フォルダパス)
• 自分が行った操作(プレビュー、ダウンロードなど)
• 表示されたエラーメッセージのスクリーンショット
• 使用しているブラウザとOSのバージョン

まとめ

BoxでCADファイルの表示に困ったとき、監査ログは原因特定の強力なツールです。エラーコードを確認することで、ファイル形式の問題なのか、サイズの問題なのか、権限の問題なのかを素早く切り分けられます。管理者でない場合は、速やかに管理者に連絡し、必要な情報を伝えることが重要です。定期的に監査ログをエクスポートしておくことで、過去のトラブルの傾向を把握し、再発防止にも役立てることができます。本記事で紹介した手順を参考に、CADファイルの表示トラブルをスムーズに解決してください。