DeepSee トラブルシューティングガイド

記事

Toshihiko Minamoto · 2023年8月23日 7m read

#ヒントとコツ #ベストプラクティス #InterSystems IRIS BI (DeepSee)

この「DeepSee トラブルシューティングガイド」は、DeepSee プロジェクトの問題を追跡して修正する支援を提供することを目的としています。

このガイドラインに従って問題を修正できない場合でも、少なくとも DeepSee サポートに WRC の問題を提出し、すべての証拠を提供するのに十分な情報を得ることができます。この情報によって、一緒に調査を続け、より迅速に解決することが可能となります。

ご注意ください: 特定のアクションやコマンドによってどのような結果がもたらされるかがよくわからない場合は、実行しないでください。本番システムに影響を与える可能性があります。この場合は、サポートセンターにお問い合わせください。

左から右の操作列に進むと、このガイドを最も簡単に活用できます。

問題の領域	発生事項	分析	解決方法
ビルドの問題	ビルド中のエラー	エラーメッセージを確認ビルドでエラーが表示されなかった場合は $System.OBJ.DisplayError() を実行 ^DeepSee.BuildErrors/ run ##class(%DeepSee.Utils).%PrintBuildErrors(pCube) を確認	メッセージのエラーを修正
	ソーステーブルの行よりも少ないレコードが構築される	キューブのビルド制限を確認	ビルド制限を削除または受領する
		maxfacts が使用されているかを確認	maxfacts を削除
		^DeepSee.BuildErrors/ run ##class(%DeepSee.Utils).%PrintBuildErrors(pCube) を確認	ビルドエラーを修正
		ソースクラスのインデックスを確認	ソースクラスのインデックス再構築
データの欠落	ソースのレコードが DeepSee で使用できない	前のセクションでビルドの問題 / 制限を確認	制限を削除します
		キューブ定義の "%OnProcessFact" を確認します	必要に応じてメソッドを修正してください
		ビルドエラーを確認します	ビルドエラーを修正してください
		sourceExpression のメソッドをデバッグします	メソッドを修正してください
		ファクトテーブルのレコードを確認します	不一致の原因を特定して解決してください
		ファクトテーブルとソーステーブルを比較します
結果が誤っている	レベルのメンバーが重複	ディメンションの階層が有効かを確認	[この記事](https://community.intersystems.com/post/designing-valid-hierarchies-deepsee)に従ってレベルを変更してください
	クエリで予期しない結果が表示される	データが欠落していないか前セクションを確認。キャッシュに問題がないか確認 - do $System.DeepSee.Shell() - cache off	ビルドのエラーを修正 do $System.DeepSee.Reset() kill ^DeepSee.Cache
		クエリをより小さなセグメントに分割（各軸を個別に分割）問題のあるセグメントを特定	セグメントの問題を修正
		^DeepSee.AgentLog を確認します	do ##class(%DeepSee.TaskMaster).%Reset()
	リストが空	リストが正常かを確認	ソーステーブルから選択する権限を付与
	リストが空	カスタム SQL リストかを確認します	WHERE 条件をデバッグ ^DeepSee.SQLError を確認 ^DeepSee.QueryLog を確認
ハング / 予期しないイベント	DeepSee が期待どおりに反応しない	システムの健全性を確認します
	ハング	エージェントステータスを確認
	ハング	ライセンスの使用状況を確認	ライセンスの追加購入
	以前に動作していた操作が失敗する	^DeepSee.AgentLog を確認	do ##class(%DeepSee.TaskMaster).%Reset()
		do ##class(%DeepSee.TaskMaster).%PrintLog() を実行
		^DeepSee.LastLogError を確認 ^DeepSee.PivotError() を確認	発見したエラーを修正
パフォーマンスの問題	ビルドパフォーマンスが低い	do ##class(%DeepSee.TaskMaster).%PrintLog() を実行
		利用できるエージェント数を確認	do ##class(%DeepSee.TaskMaster).%Reset()
		メモリと CPU の使用率を確認	低負荷の状態でビルドを実行
		ソースの式を確認	可能であれば、ソース式を避ける
		全般的なキューブの状態を確認	不要なディメンション/レベルを削除
		- do ##class(%DeepSee.Utils).%Analyze("Holefoods")	キューブを単純かつスリムに保つ
		高いジャーナリングアクティビティ	DeepSee にデータウェアハウス設計または個別のネームスペースを使用して、そのネームスペースのジャーナリングを無効にする
	クエリパフォーマンスが低い	レポートを実行します: do ##class(%DeepSee.Diagnostic.MDXUtils).%Run(<query>)	長時間実行される可能性のあるクエリは簡略化するなど回避策が必要
		メモリと CPU の使用率を確認	リソースの解放
		バッファの設定を確認	可能であれば、バッファを増やす
		一般的なシステムパフォーマンス分析を実施	ランタイム時のパフォーマンス問題への支援については、サポートセンターまでお問い合わせください
報告済みの一般的な問題	ネームスペースが DS メニューにリストされていない	DeepSee が web-application 設定 /csp/<ネームスペース> で有効であるかを確認	ウェブ・アプリケーションで "DeepSee" を有効にする
	アーキテクトがグレー表示される	ライセンスを確認	DeepSee 対応のライセンスを取得
		ユーザーのロールを確認	リソース %DeepSee_Architect , %DeepSee_ArchitectEdit に Use を追加
		ブラウザが IE 8 でないことを確認	サポートされているブラウザを使用

以下は、各問題領域のマインドマップです。

@Sascha Kisserさんが書いた元の記事へ