投稿者

インターシステムズジャパン
記事 Toshihiko Minamoto · 8月 23, 2023 7m read

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