管理ログユーティリティ

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：5分

    • 管理ログユーティリティが、 CPQ 環境の構成の問題を効率的に診断、監視、および解決するのにどのように役立つかについて説明します。

    アドミンログユーティリティを使用すると、アドミニストレーターはシステムアクティビティ、構成エラー、および統合の問題を一元的に表示できます。ランタイムの重要な詳細、エラーメッセージ、および環境に関するコンテキストデータをキャプチャすることで、問題を迅速に診断して解決できます。使いやすさと精度を念頭に置いて設計された管理ログは、管理者が問題を特定し、原因を理解し、システムの安定性を維持するために迅速に行動するのに役立ちます。

    アドミン UI からアクセスするか、API 経由でアクセスするかにかかわらず、アドミンログは、構成を最適化し、ユーザーの生産性を維持するために使用できるインサイトをアドミンに提供するのに役立ちます。

    主な特長

    表 : 1. 管理ログの主なメリット
    メリット 説明
    一元化された可視化 構成エラー、ランタイムエラー、および統合エラーを 1 か所で監視します。
    リアルタイムモニタリング ログをすばやく更新してフィルタリングし、最新の時間枠または関連する時間枠に焦点を当てます。
    迅速なトラブルシューティング 正確な診断のために、詳細なエラーコード、コンテキストメッセージ、およびユーザー ID を確認します。
    API アクセシビリティ 自動化またはカスタムダッシュボードのログデータをプログラムで取得します。
    継続的改善 強化されたエラーレポートとコンテキストの詳細にアクセスして、継続的なメンテナンスとユーザーサポートを簡素化します。

    アドミンログへのアクセス

    アドミニストレーターは、希望するワークフローとユースケースに応じて、 CPQ アドミンインターフェイスから、または API 経由で管理ログにアクセスできます。

    新しいアドミンエクスペリエンスで、[ユーティリティ] メニューの [ログ] にアクセスします。従来のアドミンエクスペリエンスでは、ナビゲーションバーの [ログ ] をクリックします。どちらのエクスペリエンスも同じリアルタイムログ記録機能を提供し、詳細なエラー情報のフィルタリング、更新、および表示を可能にします。

    リフレッシュとフィルタリング

    ログインターフェイスは、リアルタイムフィルタリングとリフレッシュオプションをサポートしています。分析ニーズに最適な時間範囲を選択します。
    • 過去 15 分間
    • 過去 1 時間
    • 過去 24 時間
    • すべてのログ
    注:
    リフレッシュボタンを使用すると、[ログ] ページを離れることなく最新のイベントでビューを更新できます。

    ログの詳細フォーマット

    各ログエントリーは構造化された形式で表示されるため、問題を簡単にスキャンして把握できます。この構造により、アドミニストレーターはさまざまなセッションやコンポーネント間でエラーを効率的にフィルタリング、関連付け、解決できます。ログデータには、次の列が含まれています。
    • 日付と時刻:分かりやすい日付表示と正確な時刻 (ミリ秒単位) (2025 年 2 月追加)。
    • エラーメッセージ:発生した問題の説明的なサマリー。
    • エラーコード: CPQ 迅速な相互参照とサポート要求のための一意の識別子。
    • ユーザー ID:エラーが発生したユーザー (2025 年 2 月追加)。

    API を介したログへのアクセス

    プログラムでログを照会することを希望するアドミニストレーターは、GET 要求を使用してアドミンログ API にアクセスできます。これは、大規模なデータセットがある環境や、ログを外部監視システムに統合する場合に特に役立ちます。この柔軟性により、アドミンはすべての履歴レコードをロードすることなく、監査またはパフォーマンスレビュー用の特定のログ間隔を取得できます。

    cURL コマンドの例:
    
    curl --location '<logikURL>/api/logs/v1/logs' \
    --header 'Content-Type: application/json' \
    --header 'Origin: localhost' \
    --header 'Authorization: <Admin API Key>'
    ISO 8601 日付/時刻形式で before パラメーターと after パラメーターを指定することで、結果を絞り込むことができます。
    
    curl --location '<logikURL>/api/logs/v1/logs?after=YYYY-MM-DDThh%3Amm%3AssZ&before=YYYY-MM-DDThh%3Amm%3AssZ' \
    --header 'Content-Type: application/json' \
    --header 'Origin: localhost' \
    --header 'Authorization: <Admin API Key>'

    継続的改善

    アドミンログは、より深いインサイトを提供し、使いやすさを向上させるために継続的に進化しています。2025 年 2 月に導入された機能拡張には、次のものが含まれます。
    • 拡張エラーメッセージ:問題をより迅速に特定できるように、保存エラーに関連する構成エラーが含まれるようになりました。
    • コンテキスト情報:拡張スクリプトエラーの場合、ログは特定の拡張領域、影響を受ける詳細計画、およびリビジョン ID をキャプチャして、正確なデバッグを行うようになりました。
    • 詳細な外部接続エラー:「サポートされていないメソッド」HTTP エラーには、外部呼び出しで使用されたパスとメソッドが含まれるようになりました。
    • パフォーマンスメトリクス:外部統合のメトリクスが追跡され、 CPQ サポートを通じて要求に応じて利用できるようになりました。

    一般的なガイドライン

    • リアルタイム構成の問題をトラブルシューティングするときは、短時間フィルターを使用します。
    • 長期的な追跡やコンプライアンスレビューのために、関連するログデータを定期的にエクスポートします。
    • API を活用してログの取得を自動化するか、組織の監視ツールと統合します。
    • 不明瞭なエラーコードやコンテキストの欠落を報告して、分析と改善のサポートを CPQ します。