JMX コンソールを使用したサーバーリソースの監視

JMX コンソールを使用すると、CRX サーバー上のサービスを監視および管理できます。以降の節では、JMX フレームワークを通じて公開される属性と操作の概要を説明します。

コンソールコントロールの使用方法については、 JMX コンソールの使用.JMX に関する背景情報については、 Java Management Extensions(JMX) テクノロジー ページをOracleWeb サイトに貼り付けます。

JMX コンソールを使用して、MBean を作成し、サービスを管理する方法について詳しくは、サービスと JMX コンソールの統合を参照してください。

ワークフローのメンテナンス

実行中、完了済み、古い、失敗したワークフローインスタンスを管理するための操作。

  • ドメイン:com.adobe.granite.workflow
  • タイプ:メンテナンス
メモ

その他のワークフロー管理ツールおよびワークフローインスタンスに考えられるステータスの説明は、ワークフローコンソールを参照してください。

運用

listRunningWorkflowsPerModel 各ワークフローモデルで実行されているワークフローインスタンスの数をリストします。

  • 引数:なし
  • 戻り値:数およびモデル ID の列を含む表形式のデータ

listCompletedWorkflowsPerModel 各ワークフローモデルの完了したワークフローインスタンスの数を表示します。

  • 引数:なし
  • 戻り値:数およびモデル ID の列を含む表形式のデータ

returnWorkflowQueueInfo 処理済みで、処理用のキューに格納されているワークフロー項目に関する情報をリストします。

  • 引数:なし

  • 戻り値:以下の列を含む表形式のデータ:

    • ジョブ
    • キュー名
    • アクティブなジョブ
    • 平均処理時間
    • 平均待機時間
    • キャンセルされたジョブ
    • 失敗したジョブ
    • 完了したジョブ
    • 処理済みのジョブ
    • 待機中のジョブ

returnWorkflowJobTopicInfo ワークフロージョブの処理情報をトピック別にリスト表示します。

  • 引数:なし

  • 戻り値:以下の列を含む表形式のデータ:

    • トピック名
    • 平均処理時間
    • 平均待機時間
    • キャンセルされたジョブ
    • 失敗したジョブ
    • 完了したジョブ
    • 処理済みのジョブ

returnFailedWorkflowCount 失敗したワークフローインスタンスの数を表示します。 ワークフローモデルを指定して、すべてのワークフローモデルに関する情報をクエリしたり取得したりできます。

  • 引数:

    • モデル:問い合わせるモデルの ID。すべてのワークフローモデルについて失敗したワークフローインスタンスの数を確認するには、値を指定しません。ID はモデルノードのパスです(例: )。

      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

  • 戻り値:失敗したワークフローインスタンスの数。

returnFailedWorkflowCountPerModel 各ワークフローモデルで失敗したワークフローインスタンスの数を表示します。

  • 引数:なし
  • 戻り値:数およびモデル ID の列を含む表形式のデータ

terminateFailedInstances 失敗したワークフローインスタンスを終了します。 失敗したインスタンスをすべて終了するか、特定のモデルの失敗したインスタンスのみを終了することができます。 オプションで、インスタンスを終了した後に再起動することができます。 また、実際に操作を実行せずに、操作をテストして結果を確認することもできます。

  • 引数:

    • インスタンスを再起動します。(オプション) true をクリックして、インスタンスを終了した後に再起動します。 のデフォルト値 false により、終了したワークフローインスタンスが再起動されません。

    • ドライラン:(オプション) true 実際に操作を実行せずに操作の結果を確認する。 のデフォルト値 false を指定すると、操作が実行されます。

    • モデル:(オプション)操作が適用されるモデルの ID。すべてのワークフローモデルの失敗したインスタンスに操作を適用するには、モデルを指定しないでください。ID はモデルノードのパスです(例: )。

      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

  • 戻り値:以下の列を含む、終了されたインスタンスに関する表形式のデータ:

    • イニシエーター
    • インスタンス ID
    • モデル ID
    • ペイロード
    • 開始コメント
    • ワークフロータイトル

retryFailedWorkItems 失敗した作業項目ステップを実行しようとします。 失敗したすべての作業項目を再試行するか、特定のワークフローモデルの失敗した作業項目のみを再試行できます。 必要に応じて、操作をテストし、実際に操作を実行せずに結果を確認できます。

  • 引数:

    • ドライラン:(オプション) true 実際に操作を実行せずに操作の結果を確認する。 のデフォルト値 false を指定すると、操作が実行されます。

    • モデル:(オプション)操作が適用されるモデルの ID。すべてのワークフローモデルの失敗した作業項目に操作を適用するモデルを指定しません。ID はモデルノードのパスです(例: )。

      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

  • 戻り値:以下の列を含む、再試行された作業項目に関する表形式のデータ:

    • イニシエーター
    • インスタンス ID
    • モデル ID
    • ペイロード
    • 開始コメント
    • ワークフロータイトル

PurgeActive 特定のページのアクティブなワークフローインスタンスを削除します。 すべてのモデルのアクティブなインスタンス、または特定のモデルのインスタンスのみをパージできます。 オプションで、操作をテストして、実際に操作を実行せずに結果を確認できます。

  • 引数:

    • モデル:(オプション)操作が適用されるモデルの ID。すべてのワークフローモデルのワークフローインスタンスに操作を適用するモデルを指定しません。ID はモデルノードのパスです(例: )。

      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

    • ワークフローが開始してからの日数:パージするワークフローインスタンスの有効期間(日数)。

    • ドライラン:(オプション) true 実際に操作を実行せずに操作の結果を確認する。 のデフォルト値 false を指定すると、操作が実行されます。

  • 戻り値:以下の列を含む、パージされたアクティブなワークフローインスタンスに関する表形式のデータ:

    • イニシエーター
    • インスタンス ID
    • モデル ID
    • ペイロード
    • 開始コメント
    • ワークフロータイトル

countStaleWorkflows 古いワークフローインスタンスの数を返します。 すべてのワークフローモデルまたは特定のモデルの古いインスタンスの数を取得できます。

  • 引数:

    • モデル:(オプション)操作が適用されるモデルの ID。すべてのワークフローモデルのワークフローインスタンスに操作を適用するモデルを指定しません。ID はモデルノードのパスです(例: )。

      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

  • 戻り値:古くなったワークフローインスタンスの数。

restartStaleWorkflows 古いワークフローインスタンスを再起動します。 特定のモデルの古くなったすべてのインスタンスまたは古くなったインスタンスのみを再起動できます。 また、実際に操作を実行せずに、操作をテストして結果を確認することもできます。

  • 引数:

    • モデル:(オプション)操作が適用されるモデルの ID。すべてのワークフローモデルの古くなったインスタンスに操作を適用するには、モデルを指定しないでください。ID はモデルノードのパスです(例: )。

      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

    • ドライラン:(オプション) true 実際に操作を実行せずに操作の結果を確認する。 のデフォルト値 false を指定すると、操作が実行されます。

  • 戻り値:再開されたワークフローインスタンスのリスト。

fetchModelList すべてのワークフローモデルをリストします。

  • 引数:なし
  • 戻り値:モデル ID 列とモデル名列を含む、ワークフローモデルを識別する表形式のデータ。

countRunningWorkflows 実行中のワークフローインスタンスの数を返します。 すべてのワークフローモデルまたは特定のモデルに対して実行中のインスタンスの数を取得できます。

  • 引数:

    • モデル:(オプション)実行中のインスタンス数が返されるモデルの ID。すべてのワークフローモデルの実行中のインスタンス数を返すモデルを指定しません。ID はモデルノードのパスです(例: )。

      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

  • 戻り値:実行中のワークフローインスタンスの数。

countCompletedWorkflows 完了したワークフローインスタンスの数を返します。 すべてのワークフローモデルまたは特定のモデルの完了済みインスタンスの数を取得できます。

  • 引数:

    • モデル:(オプション)完了したインスタンスの数が返されるモデルの ID。すべてのワークフローモデルの完了したインスタンスの数を返すモデルを指定しません。ID はモデルノードのパスです(例: )。

      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

  • 戻り値:完了したワークフローインスタンスの数。

purgeCompleted 特定の年齢の完了したワークフローのレコードをリポジトリから削除します。 ワークフローを大量に使用する場合に、この操作を定期的に使用して、リポジトリのサイズを最小限に抑えます。 すべてのモデルの完了済みインスタンスをパージするか、特定のモデルのインスタンスのみをパージできます。 オプションで、操作をテストして、実際に操作を実行せずに結果を確認できます。

  • 引数:

    • モデル:(オプション)操作が適用されるモデルの ID。すべてのワークフローモデルのワークフローインスタンスに操作を適用するモデルを指定しません。ID はモデルノードのパスです(例: )。

      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

    • ワークフローが完了してからの日数:ワークフローインスタンスが完了状態になっている日数。

    • ドライラン:(オプション) true 実際に操作を実行せずに操作の結果を確認する。 のデフォルト値 false を指定すると、操作が実行されます。

  • 戻り値:以下の列を含む、パージされた完了済みのワークフローインスタンスに関する表形式のデータ:

    • イニシエーター
    • インスタンス ID
    • モデル ID
    • ペイロード
    • 開始コメント
    • ワークフロータイトル

リポジトリ

CRX リポジトリに関する情報

  • ドメイン:com.adobe.granite
  • タイプ:リポジトリ

属性

名前 JCR リポジトリ実装の名前。 読み取り専用。

バージョン リポジトリの実装バージョン。 読み取り専用。

HomeDir リポジトリが配置されているディレクトリ。 デフォルトの場所は次のとおりです。 <quickstart_jar_location>/crx-quickstart/repository を追加します。 読み取り専用。

CustomerName ソフトウェアライセンスの発行先のお客様の名前。 読み取り専用。

LicenseKey リポジトリのこのインストール用の一意のライセンスキー。 読み取り専用。

AvailableDiskSpace リポジトリのこのインスタンスで使用可能なディスク領域 (MB)。 読み取り専用。

MaximumNumberOfOpenFiles 一度に開くことができるファイルの数。 読み取り専用。

SessionTracker crx.debug.sessions システム変数の値。 true は、デバッグセッションを示します。 false は通常のセッションを示します。 読み取り/書き込み。

記述子 リポジトリのプロパティを表すキーと値のペアのセット。 すべてのプロパティは読み取り専用です。

キー
option.node.and.property.with.same.name.supported ノードとノードのプロパティに同じ名前を指定できるかどうかを示します。true は同じ名前がサポートされていることを示し、false はサポートされていないことを示します。
identifier.stability 参照不可能なノード識別子の安定性を示します。以下の値が指定可能です。
  • identifier.stability.indefinite.duration:識別子は変わりません。
  • identifier.stability.method.duration:メソッド呼び出しの合間に識別子が変わる可能性があります。
  • identifier.stability.save.duration:保存/更新サイクル内では、識別子は変わりません。
  • identifier.stability.session.duration:セッション中は、識別子は変わりません。
query.xpath.pos.index JCR 1.0 XPath クエリ言語がサポートされているかどうかを示します。true はサポートを示し、false はサポートなしを示します。
crx.repository.systemid system.id ファイル内のシステム識別子。
option.query.sql.supported JCR 1.0 XPath クエリ言語がサポートされているかどうかを示します。true はサポートを示し、false はサポートなしを示します。
jcr.repository.version リポジトリ実装のバージョン。
option.update.primary.node.type.supported あるノードのプライマリノードタイプを変更できるかどうかを示します。true はプライマリノードタイプを変更できることを示し、false は変更がサポートされていないことを示します。
option.node.type.management.supported ノードタイプの管理がサポートされているかどうかを示します。true はサポートされていることを示し、false はサポートなしを示します。
node.type.management.overrides.supported 継承されたプロパティまたは子ノードで定義されているノードタイプを上書きできるかどうかを示します。true は上書きがサポートされていることを示し、false は上書きなしを示します。
option.observation.supported true はリポジトリ変更の非同期の監視がサポートされていることを示します。非同期の監視をサポートすると、変更が発生するたびに、アプリケーションが通知を受け取ったり、通知に応答したりできます。
query.jcrscore

true は、フルテキスト検索を実行するために jcrfn:contains 関数(XPath の場合)または CONTAINS 関数を含む XPath および SQL クエリで、jcr:score 疑似プロパティが使用できることを示します。

option.simple.versioning.supported true は、リポジトリが単純なバージョン管理をサポートしていることを示します。単純なバージョン管理を使用すると、一連の連続したノードのバージョンが維持されます。
option.workspace.management.supported true は、API を使用したワークスペースの作成および削除をリポジトリがサポートしていることを示します。
option.update.mixin.node.types.supported true は、既存のノードの mixin ノードタイプの追加および削除をリポジトリがサポートしていることを示します。
node.type.management.primary.item.name.supported true は、プライマリ項目を子として含めるノード定義がリポジトリによって可能になることを示します。プライマリ項目は、項目名がわからなくとも、API を使用してアクセスできます。
level.2.supported true は、LEVEL_1_SUPPORTED と OPTION_XML_IMPORT_SUPPORTED がいずれも true であることを示します。
write.supported true はリポジトリによって API を使用した書き込みアクセスが提供されることを示し、false は読み取り専用アクセスを示します。
node.type.management.update.in.use.supported true は、既存のノードで使用中のノード定義を変更できることを示します。
jcr.specification.version リポジトリが実装する JCR 仕様のバージョン。
option.journaled.observation.supported true は、アプリケーションがリポジトリのジャーナル監視を実行できることを示します。ジャーナル監視を使用すると、一連の変更通知を特定の期間にわたって取得できます。
query.languages リポジトリがサポートするクエリ言語。値なしは、クエリサポートがないことを示します。
option.xml.export.supported true は、ノードを XML コードとして書き出すことをリポジトリがサポートしていることを示します。
node.type.management.multiple.binary.properties.supported true は複数のバイナリプロパティを持つノードタイプの登録をリポジトリがサポートしていることを示し、false は 1 つのノードタイプに対して単一のバイナリプロパティがサポートされていることを示します。
option.access.control.supported true は、ノードアクセス用のユーザーの権限を設定および決定するために、リポジトリがアクセス制御をサポートすることを示します。
option.baselines.supported true は、リポジトリが設定とベースラインの両方をサポートしていることを示します。
option.shareable.nodes.supported true は、リポジトリが共有可能なノードの作成をサポートしていることを示します。
crx.cluster.id リポジトリクラスターの識別子。
query.stored.queries.supported true は、保存されたクエリをリポジトリがサポートしていることを示します。
query.full.text.search.supported true は、リポジトリがフルテキスト検索をサポートしていることを示します。
node.type.management.inheritance

ノードタイプの継承に関するリポジトリサポートのレベルを示します。以下の値が指定可能です。

node.type.management.inheritance.minimal:プライマリノードタイプの登録は、nt:base のみをスーパータイプとして持つものに限られます。mixin ノードタイプの登録は、スーパータイプがないものに限られます。

node.type.management.inheritance.single:プライマリノードタイプの登録は、スーパータイプが 1 つのものに限られます。mixin ノードタイプの登録は、最大 1 つのスーパータイプを持つものに限られます。


node.type.management.inheritance.multiple:プライマリノードタイプは、1 つ以上のスーパータイプに登録できます。Mixin ノードタイプは、0 個以上のスーパータイプに登録できます。

crx.cluster.preferredMaster true は、このクラスターノードがクラスターのマスターとして望ましいことを示します。
option.transactions.supported true は、リポジトリがトランザクションをサポートしていることを示します。
jcr.repository.vendor.url リポジトリベンダーの URL。
node.type.management.value.constraints.supported true は、ノードプロパティの値の制約をリポジトリがサポートしていることを示します。
node.type.management.property.types 登録済みのノードタイプが指定できるプロパティタイプを表す javax.jcr.PropertyType 定数の配列です。長さ 0 の配列は、登録されたノードタイプがプロパティ定義を指定できないことを示します。プロパティの型は、STRING、URI、BOOLEAN、LONG、DOUBLE、DECIMAL、BINARY、DATE、NAME、PATH、WEAKREFERENCE、REFERENCE、UNDEFINED(サポートされている場合)です。
node.type.management.orderable.child.nodes.supported true は、子ノードの順序の保持をリポジトリがサポートしていることを示します。
jcr.repository.vendor リポジトリベンダーの名前。
query.joins

クエリ内の結合のサポートレベル。以下の値が指定可能です。

  • query.joins.none:結合のサポートなし。クエリでは 1 つのセレクターを使用できます。
  • query.joins.inner:内部結合のサポート。
  • query.joins.inner.outer:内部結合と外部結合のサポート。
org.apache.jackrabbit.spi.commons.AdditionalEventInfo
query.xpath.doc.order true は、リポジトリが XPath 1.0 クエリ言語をサポートしていることを示します。
query.jcrpath
option.xml.import.supported true は、XML コードをコンテンツとして読み込むことをリポジトリがサポートしていることを示します。
node.type.management.same.name.siblings.supported true は、同じ名前の兄弟ノード(親が同じノード)をリポジトリがサポートしていることを示します。
node.type.management.residual.definitions.supported true は、残差定義を持つ名前プロパティをリポジトリがサポートしていることを示します。サポートされている場合、項目定義の名前属性にアスタリスク(「*」)を指定できます。
node.type.management.autocreated.definitions.supported true は、ノード作成時にそのノードの子項目(ノードまたはプロパティ)の自動作成をリポジトリがサポートしていることを示します。
crx.cluster.master true は、このリポジトリノードがクラスターのマスターノードであることを示します。
level.1.supported true は、option.xml.export.support が true であり、query.languages がゼロ以外の長さであることを示します。
option.unfiled.content.supported true は、ファイルされていないコンテンツをリポジトリがサポートしていることを示します。ファイルされていないノードは、リポジトリ階層の一部ではありません。
jcr.specification.name リポジトリが実装する JCR 仕様の名前。
option.versioning.supported true は、リポジトリが完全なバージョン管理をサポートしていることを示します。
jcr.repository.name リポジトリの名前。
option.locking.supported true は、リポジトリがノードのロックをサポートしていることを示します。ロックすると、他のユーザーが一時的に変更できなくなります。
jcr.repository.version.display
option.activities.supported true は、リポジトリがアクティビティをサポートしていることを示します。アクティビティとは、別のワークスペースに結合されるワークスペースで実行される一連の変更です。
node.type.management.multivalued.properties.supported true は、ゼロ個以上の値を指定できるノードプロパティをリポジトリがサポートしていることを示します。
option.retention.supported true は、保持ポリシーをコンテンツに適用する外部保持管理アプリケーションの使用、および保持と解放を、リポジトリがサポートしていることを示します。
option.lifecycle.supported true は、リポジトリがライフサイクル管理をサポートしていることを示します。

WorkspaceNames リポジトリ内のワークスペースの名前。 読み取り専用。

DataStoreGarbageCollectionDelay 10 ノードごとにスキャンした後、ガベージコレクションがスリープする時間(ミリ秒単位)。 読み取り/書き込み。

BackupDelay バックアップ・プロセスが、バックアップの各ステップの間にスリープする時間(ミリ秒単位)。 読み取り/書き込み。

BackupInProgress 値 true は、バックアッププロセスが実行中であることを示します。 読み取り専用。

BackupProgress 現在のバックアップの場合、バックアップされたすべてのファイルの割合。 読み取り専用。

CurrentBackupTarget 現在のバックアップの場合は、バックアップファイルが保存される ZIP ファイル。 バックアップが進行中でない場合は、値は表示されません。 読み取り専用。

BackupWasSuccessful 値が true の場合、現在のバックアップ中にエラーが発生していないか、進行中のバックアップがありません。 false は、現在のバックアップ中にエラーが発生したことを示します。 読み取り専用。

BackupResult 現在のバックアップのステータス。 次の値を指定できます。

  • バックアップ中:バックアップが現在実行中です。
  • バックアップキャンセル:バックアップがキャンセルされました。
  • バックアップでエラー発生:バックアップ中にエラーが発生しました。エラーメッセージでは、原因に関する情報が提供されます。
  • バックアップ完了:バックアップが成功しました。
  • バックアップの実行なし:進行中のバックアップがありません。

読み取り専用。

TarOptimizationRunningSince 現在の TAR ファイル最適化プロセスが開始された時刻。 読み取り専用。

TarOptimizationDelay TAR 最適化プロセスがプロセスの各ステップの間にスリープする時間(ミリ秒単位)。 読み取り/書き込み。

ClusterProperties クラスターのプロパティと値を表すキーと値のペアのセット。 表の各行は、クラスタ・プロパティを表します。 読み取り専用。

ClusterNodes リポジトリクラスターのメンバー。

ClusterId このリポジトリクラスターの識別子。 読み取り専用。

ClusterMasterId このリポジトリクラスターのマスターノードの識別子。 読み取り専用。

ClusterNodeId リポジトリクラスターのこのノードの識別子。 読み取り専用。

運用

createWorkspace このリポジトリにワークスペースを作成します。

  • 引数:

    • 名前:新しいワークスペースの名前を表す String 値。
  • 戻り値:なし

runDataStoreGarbageCollection リポジトリノードでガベージコレクションを実行します。

  • 引数:

    • 削除:未使用のリポジトリ項目を削除するかどうかを示す Boolean 値です。値が true の場合、未使用のノードおよびプロパティが削除されます。値が false の場合、すべてのノードがスキャンされますが、何も削除されません。
  • 戻り値:なし

stopDataStoreGarbageCollection 実行中のデータストアのガベージコレクションを停止します。

  • 引数:なし
  • 戻り値:現在のステータスの文字列表現

startBackup リポジトリデータを ZIP ファイルにバックアップします。

  • 引数:

    • target:(オプション) A String リポジトリデータをアーカイブする ZIP ファイルまたはディレクトリの名前を表す値。 ZIP ファイルを使用するには、ZIP ファイル名の拡張子を含めます。 ディレクトリを使用する場合は、ファイル名の拡張子を含めません。

      増分バックアップを実行するには、以前にバックアップに使用したディレクトリを指定します。

      絶対パスまたは相対パスを指定できます。 相対パスは、crx-quickstart ディレクトリの親を基準とした相対パスです。

      値を指定しない場合、デフォルト値は backup-currentdate.zip が使用され、ここで currentdate の形式はです yyyyMMdd-HHmm.

  • 戻り値:なし

cancelBackup 現在のバックアッププロセスを停止し、データのアーカイブ用にプロセスが作成した一時アーカイブを削除します。

  • 引数:なし
  • 戻り値:なし

blockRepositoryWrites リポジトリデータに対する変更をブロックします。 すべてのリポジトリバックアップリスナーに、ブロックの通知が送信されます。

  • 引数:なし
  • 戻り値:なし

unblockRepositoryWrites リポジトリからブロックを削除します。 すべてのリポジトリバックアップリスナーに、ブロックの削除が通知されます。

  • 引数:なし
  • 戻り値:なし

startTarOptimization tarOptimizationDelay のデフォルト値を使用して TAR ファイルの最適化プロセスを開始します。

  • 引数:なし
  • 戻り値:なし

stopTarOptimization TAR ファイルの最適化を停止します。

  • 引数:なし
  • 戻り値:なし

tarIndexMerge すべての TAR セットの上位のインデックスファイルを結合します。 上位のインデックスファイルは、異なるメジャーバージョンのファイルです。 例えば、次のファイルが index_3_1.tar ファイルに結合されます。index_1_1.tar、index_2_0.tar、index_3_0.tar。 結合されたファイルが削除されます(前の例では、index_1_1.tar、index_2_0.tar、および index_3_0.tar が削除されます)。

  • 引数:

    • background:実行中に Web コンソールを使用できるように、操作をバックグラウンドで実行するかどうかを示す Boolean 値です。 値 true は、操作をバックグラウンドで実行します。
  • 戻り値:なし

becomeClusterMaster このリポジトリノードをクラスターのマスターノードとして設定します。 まだ master でない場合、このコマンドは現在のマスターインスタンスのリスナーを停止し、現在のノードのマスターリスナーを開始します。 その後、このノードがマスターノードとして設定され、再起動されると、クラスター内の他のすべてのノード(マスターによって制御されるノード)がこのインスタンスに接続します。

  • 引数:なし
  • 戻り値:なし

joinCluster このリポジトリを、クラスターマスターによって制御されるノードとしてクラスターに追加します。 認証を目的として、ユーザー名とパスワードを指定する必要があります。 接続では基本認証を使用します。 セキュリティ資格情報は、サーバーに送信される前に base-64 エンコードされます。

  • 引数:

    • master:マスターリポジトリノードを実行するコンピューターの IP アドレスまたはコンピューター名を表す文字列値。
    • username:クラスターでの認証に使用する名前。
    • password:認証に使用するパスワード。
  • 戻り値:なし

traversalCheck 特定のノードで始まるサブツリー内の不整合をトラバースし、オプションで修正します。 これについては、永続性マネージャーに関するドキュメントで詳しく説明します。

consistencyCheck データストアの整合性を確認し、オプションで修正します。 これについて詳しくは、データストアのドキュメントを参照してください。

リポジトリ統計(TimeSeries)

org.apache.jackrabbit.api.stats.RepositoryStatistics で定義される、各統計タイプの TimeSeries フィールドの値。

  • ドメイン: com.adobe.granite

  • 型:TimeSeries

  • 名前:次の org.apache.jackrabbit.api.stats.RepositoryStatistics.Type Enum クラス:

    • BUNDLE_CACHE_ACCESS_COUNTER
    • BUNDLE_CACHE_MISS_AVERAGE
    • BUNDLE_CACHE_MISS_COUNTER
    • BUNDLE_CACHE_MISS_DURATION
    • BUNDLE_CACHE_SIZE_COUNTER
    • BUNDLE_COUNTER
    • BUNDLE_READ_COUNTER
    • BUNDLE_WRITE_AVERAGE
    • BUNDLE_WRITE_COUNTER
    • BUNDLE_WRITE_DURATION
    • BUNDLE_WS_SIZE_COUNTER
    • QUERY_AVERAGE
    • QUERY_COUNT
    • QUERY_DURATION
    • SESSION_COUNT
    • SESSION_LOGIN_COUNTER
    • SESSION_READ_AVERAGE
    • SESSION_READ_COUNTER
    • SESSION_READ_DURATION
    • SESSION_WRITE_AVERAGE
    • SESSION_WRITE_COUNTER
    • SESSION_WRITE_DURATION

属性

報告される統計タイプごとに、以下の属性が提供されています。

  • ValuePerSecond:過去 1 分間の、1 秒あたりの測定値。読み取り専用。
  • ValuePerMinute:過去 1 時間の、1 分あたりの測定値。読み取り専用。
  • ValuePerHour:先週の 1 時間あたりの測定値。読み取り専用。
  • 週ごとの値:過去 3 年間の 1 週間あたりの測定値。読み取り専用。

リポジトリクエリ統計

リポジトリクエリに関する統計情報。

  • ドメイン:com.adobe.granite
  • タイプ:QueryStat

属性

SlowQueries 完了に最も時間がかかったリポジトリクエリに関する情報です。 読み取り専用。

SlowQueriesQueueSize SlowQueries リストに含めるクエリの最大数です。 読み取り/書き込み。

PopularQueries 最も多く発生したリポジトリクエリに関する情報です。 読み取り専用。

PopularQueriesQueueSize PopularQueries リスト内のクエリの最大数。 読み取り/書き込み。

運用

clearSlowQueriesQueue SlowQueries リストからすべてのクエリを削除します。

  • 引数:なし
  • 戻り値:なし

clearPopularQueriesQueue PopularQueries リストからすべてのクエリを削除します。

  • 引数:なし
  • 戻り値:なし

レプリケーションエージェント

レプリケーションエージェントごとにサービスを監視します。レプリケーションエージェントを作成すると、JMX コンソールにサービスが自動的に表示されます。

  • ドメイン: com.adobe.granite.replication
  • タイプ: エージェント
  • 名前: 値なし
  • プロパティ: {id="名前"}、ここで 名前 はエージェントの「名前」プロパティの値です。

属性

ID レプリケーションエージェント設定の識別子を表す String 値です。 複数のエージェントが同じ設定を使用できます。 読み取り専用。

有効 エージェントが正しく設定されているかどうかを示す boolean 値。

  • true:有効な設定です。
  • false :設定にエラーが含まれています。

読み取り専用。

有効 エージェントが有効かどうかを示す boolean 値。

  • true: Enabled.
  • false: 無効.

QueueBlocked キューが存在し、ブロックされているかどうかを示す boolean 値です。

  • true: ブロック. 自動再試行は保留中です。
  • false:ブロックされていないか、存在しません。

読み取り専用。

QueuePaused ジョブキューが一時停止されているかどうかを示す boolean 値です。

  • true:一時停止(休止)
  • false:一時停止していないか、存在しません。

読み取り/書き込み。

QueueNumEntries エージェントキュー内のジョブ数を表す int 値です。 読み取り専用。

QueueStatusTime 表示されているステータス値が取得されたサーバー上の時間を示す Date 値です。 値は、ページが読み込まれた時刻に対応します。 読み取り専用。

QueueNextRetryTime ブロックされたキューに対して、次回の自動再試行がいつおこなわれるかを示す Date 値。 時間が表示されない場合、キューはブロックされません。 読み取り専用。

QueueProcessingSince 現在のジョブの処理がいつ開始されたかを示す Date 値です。 時間が表示されない場合、キューはブロックまたはアイドル状態です。 読み取り専用。

QueueLastProcessTime 前のジョブがいつ完了したかを示す Date 値です。 読み取り専用。

運用

queueForceRetry ブロックされたキューに対して、再試行コマンドをキューに発行します。

  • 引数:なし
  • 戻り値:なし

queueClear キューからすべてのジョブを削除します。

  • 引数:なし
  • 戻り値:なし

Sling エンジン

HTTP 要求に関する統計を提供し、SlingRequestProcessor サービスのパフォーマンスを監視できるようにします。

  • ドメイン:org.apache.sling
  • タイプ:エンジン
  • プロパティ:

属性

RequestsCount 統計が最後にリセットされてから発生した要求の数。

MinRequestDurationMsec 統計が最後にリセットされてから、リクエストの処理に必要な最短の時間(ミリ秒)。

MaxRequestDurationMsec 統計が最後にリセットされてから、要求の処理に必要な最長時間(ミリ秒)。

StandardDeviationDurationMsec リクエストの処理に必要な時間の標準偏差です。 標準偏差は、統計が最後にリセットされてからのすべてのリクエストを使用して計算されます。

MeanRequestDurationMsec リクエストの処理に必要な平均時間。 平均は、統計が最後にリセットされてからのすべてのリクエストを使用して計算されます

運用

resetStatistics すべての統計をゼロに設定します。 特定の期間内にリクエスト処理のパフォーマンスを分析する必要がある場合に、統計をリセットします。

  • 引数:なし
  • 戻り値:なし

パッケージマネージャー

パッケージマネージャーに含まれるすべてのパッケージに関する情報。

  • ドメイン:com.adobe.granite.packaging
  • タイプ:マネージャー

クイックスタートランチャー

起動プロセスおよびクイックスタートランチャーに関する情報。

  • ドメイン:com.adobe.granite.quickstart
  • タイプ:ランチャー

運用

log

クイックスタートウィンドウにメッセージを表示します。

引数:

  • p1:A String 表示するメッセージを表す値。 次の図は、呼び出しの結果を示しています log p1 値が this is a log message.

launcheruilog

  • 戻り値:なし

startupFinished

サーバーランチャーの startupFinished メソッドを呼び出します。このメソッドにより、Web ブラウザーにようこそページが開きます。

  • 引数:なし
  • 戻り値:なし

startupProgress

サーバー起動プロセスの完了値を設定します。クイックスタートウィンドウの進行状況バーが、完了値を表します。

  • 引数:

    • p1:起動プロセスがどの程度完了したかを割合で表す浮動小数値。値の範囲はゼロから 1 です。例えば、0.3 は 30% 完了を示します。
  • 戻り値:なし。

launchprogress

サードパーティのサービス

いくつかのサードパーティのサーバーリソースでは、MBean がインストールされ、これによって属性および操作が JMX コンソールに提供されます。次の表では、サードパーティのリソースをリストし、詳細のリンクを提供します。

ドメイン タイプ MBean クラス
JMImplementation MBeanServerDelegate javax.management.MBeanServerDelegate
com.sun.management HotSpotDiagnostic com.sun.management.HotSpotDiagnosticMXBean
java.lang
  • ClassLoading
  • Compilation
  • GarbageCollector
  • メモリ
  • MemoryManager
  • MemoryPool
  • OperatingSystem
  • Runtime
  • Threading
javax.management パッケージ
java.util.logging java.util.logging.LoggingMXBean
osgi.core
  • bundleState
  • framework
  • packageState
  • serviceState
org.osgi.jmx.framework パッケージ

JMX コンソールの使用

JMX コンソールには、サーバー上で実行されているいくつかのサービスに関する情報が表示されます。

  • 属性:設定や実行時データなどのサービスプロパティ。属性は、読み取り専用の場合と読み取り/書き込み可能な場合があります。
  • 操作:サービスで呼び出し可能なコマンド。

OSGi サービスでデプロイされる MBean により、サービスの属性および操作がコンソールに公開されます。MBean は、公開される属性および操作と、属性が読み取り専用か読み取り/書き込みかを決定します。

JMX コンソールのメインページには、サービスの表が含まれます。表の行ごとに、MBean によって公開されるサービスを 1 つずつ表します。

  1. Web コンソールを開いて「JMX」タブをクリックします(http://localhost:4502/system/console/jmx)。
  2. 任意のサービスのセル値をクリックして、そのサービスの属性と操作を確認します。
  3. 属性値を変更するには、値をクリックし、表示されるダイアログボックスで値を指定して、「保存」をクリックします。
  4. サービスの操作を呼び出すには、操作名をクリックし、表示されるダイアログボックスで引数値を指定して、「呼び出し」をクリックします。

監視のための外部 JMX アプリケーションの使用

CRX を使用すると、外部アプリケーションと Managed Bean(MBean)が Java Management Extensions(JMX)経由でやり取りできます。JConsole のような汎用コンソールやドメイン専用の監視アプリケーションを使用すると、CRX の設定やプロパティを取得および設定したり、パフォーマンスやリソース使用状況を監視したりできます。

JConsole を使用した CRX への接続

JConsole を使用して CRX に接続するには、次の手順に従います。

  1. ターミナルウィンドウを開きます。

  2. 以下のコマンドを入力します。

    jconsole

JConsole が起動して、JConsole ウィンドウが表示されます。

ローカルの CRX プロセスへの接続

JConsole には、ローカルの Java 仮想マシンプロセスのリストが表示されます。このリストには 2 つのクイックスタートプロセスが含まれます。ローカルプロセスのリストから、クイックスタート「CHILD」プロセス(通常は PID が大きいほうのプロセス)を選択します。

screen_shot_2012-03-26at114557am

リモートの CRX プロセスへの接続

リモート CRX プロセスに接続するには、リモート CRX プロセスをホストする JVM で、リモート JMX 接続を受け入れるように有効にする必要があります。

リモート JMX 接続を有効にするには、JVM の起動時に次のシステムプロパティを設定する必要があります。

com.sun.management.jmxremote.port=portNum

上記のプロパティで、 portNum は、JMX RMI 接続を有効にするポート番号です。 未使用のポート番号を必ず指定してください。 ローカルアクセス用の RMI コネクタを公開する以外に、このプロパティを設定すると、既知の名前「jmxrmi」を使用して、指定したポートのプライベート読み取り専用レジストリに追加の RMI コネクタが公開されます。

デフォルトでは、リモート監視用に JMX エージェントを有効にすると、Java VM 起動時に以下のシステムプロパティを使用して指定する必要のあるパスワードファイルに基づいたパスワード認証が使用されます。

com.sun.management.jmxremote.password.file=pwFilePath

パスワードファイルの設定について詳しくは、関連する JMX のドキュメントを参照してください。

例:

$ java
  -Dcom.sun.management.jmxremote.password.file=pwFilePath
  -Dcom.sun.management.jmxremote.port=8463
  -jar ./cq-quickstart.jar

CRX で提供される MBean の使用

クイックスタートプロセスに接続後、JConsole では、CRX が実行されている JVM に対して、様々な一般的監視ツールが提供されます。

screen_shot_2012-03-26at115056am

CRX の内部監視および設定オプションにアクセスするには、「MBean」タブに移動して、左側にある階層型のコンテンツツリーから、属性または操作の関心のあるセクションを選択します。例えば、com.adobe.granite/Repository/Operations セクションなどです。

そのセクション内で、必要な属性または操作を左ウィンドウから選択します。

screen_shot_2012-03-26at115728am

このページ