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

最終更新日: 2023-12-07

JMX コンソールを使用すると、CRX サーバー上のサービスを監視および管理できます。以下の節では、JMX フレームワークによって明らかになる属性および操作についてまとめます。

コンソール制御の使用方法について詳しくは、JMX コンソールの使用を参照してください。JMX の背景情報については、Oracle web サイトの Java Management Extensions (JMX) Technology ページを参照してください。

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

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

実行中、完了済み、期限切れ、または失敗したワークフローインスタンスを管理するための操作です。

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

詳しくは、 ワークフローコンソール 追加のワークフロー管理ツールおよび考えられるワークフローインスタンスのステータスの説明。

運用

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

  • 引数:なし
  • 戻り値: Count 列と ModelId 列を含む表形式のデータ。

listCompletedWorkflowsPerModel ワークフローモデルごとに、完了したワークフローインスタンスの数をリストします。

  • 引数:なし
  • 戻り値: Count 列と ModelId 列を含む表形式のデータ。

returnWorkflowQueueInfo 処理済み、および処理に向けて待機中のワークフロー項目に関する情報をリストします。

  • 引数:なし

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

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

returnWorkflowJobTopicInfo ワークフロージョブの処理情報を、トピックごとにまとめてリストします。

  • 引数:なし

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

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

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

  • 引数:

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

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

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

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

  • 引数:なし。
  • 戻り値:カウント列とモデル ID 列を含む表形式のデータ。

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

  • 引数:

    • インスタンスを再開:(オプション) true 値を指定して、インスタンスを終了後に再開します。デフォルト値 false では、終了したワークフローインスタンスは再開されません。

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

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

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

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

    • 開始者
    • InstanceId
    • ModelId
    • ペイロード
    • StartComment
    • WorkflowTitle

retryFailedWorkItems 失敗した作業項目のステップの実行を試みます。失敗した作業項目をすべて再試行するか、特定のワークフローモデルの失敗した作業項目のみを再試行するかを指定できます。オプションで、操作をテストして、実際に操作を行わずに結果を確認することもできます。

  • 引数:

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

    • モデル:(オプション)操作の適用先のモデルの ID。モデルを指定しない場合は、すべてのワークフローモデルの失敗した作業項目に対して操作が適用されます。ID は model ノードのパスで、例えば、次のようになります。

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

  • 戻り値:再試行された失敗した作業項目に関する表形式のデータ。次の列が含まれます。

    • 開始者
    • InstanceId
    • ModelId
    • ペイロード
    • StartComment
    • WorkflowTitle

PurgeActive 特定の時間が経過したアクティブなワークフローインスタンスを削除します。すべてのモデルのアクティブなインスタンスをパージするか、特定のモデルのインスタンスのみをパージするかを指定できます。オプションで、操作をテストして、実際に操作を行わずに結果を確認することもできます。

  • 引数:

    • モデル:(オプション)操作の適用先のモデルの ID。モデルを指定しない場合は、すべてのワークフローモデルのワークフローインスタンスに対して操作が適用されます。ID は model ノードのパスで、例えば、次のようになります。

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

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

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

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

    • 開始者
    • InstanceId
    • ModelId
    • ペイロード
    • StartComment
    • WorkflowTitle

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

  • 引数:

    • モデル:(オプション)操作の適用先のモデルの ID。モデルを指定しない場合は、すべてのワークフローモデルのワークフローインスタンスに対して操作が適用されます。ID は model ノードのパスで、例えば、次のようになります。

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

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

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

  • 引数:

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

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

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

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

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

  • 引数:なし
  • 戻り値: ModelId 列や ModelName 列など、ワークフローモデルを識別する表形式のデータ。

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

  • 引数:

    • モデル:(オプション)実行中のインスタンスの数を返すモデルの ID。モデルを指定しない場合は、すべてのワークフローモデルの実行中のインスタンスの数が返されます。ID は model ノードのパスで、例えば、次のようになります。

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

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

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

  • 引数:

    • モデル:(オプション)完了したインスタンスの数を返すモデルの ID。モデルを指定しない場合は、すべてのワークフローモデルの完了したインスタンスの数が返されます。ID は model ノードのパスで、例えば、次のようになります。

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

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

purgeCompleted 特定の期間が経過した完了済みワークフローの記録をリポジトリから削除します。この操作を定期的に使用すると、ワークフローを多用するときにリポジトリのサイズを最小限に抑えることができます。すべてのモデルの完了したインスタンスをパージするか、特定のモデルのインスタンスのみをパージするかを指定できます。オプションで、操作をテストして、実際に操作を行わずに結果を確認することもできます。

  • 引数:

    • モデル:(オプション)操作の適用先のモデルの ID。モデルを指定しない場合は、すべてのワークフローモデルのワークフローインスタンスに対して操作が適用されます。ID は model ノードのパスで、例えば、次のようになります。

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

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

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

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

    • 開始者
    • InstanceId
    • ModelId
    • ペイロード
    • StartComment
    • WorkflowTitle

リポジトリ

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

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

属性

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

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

HomeDir リポジトリが配置されているディレクトリ。デフォルトの場所は、<QuickStart_Jar_Location>/crx-quickstart/repository です。読み取り専用。

CustomerName ソフトウェアライセンスの発行対象である顧客の名前。読み取り専用。

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

AvailableDiskSpace リポジトリのこのインスタンスで使用可能なディスク容量(メガバイト単位)。読み取り専用。

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

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

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

キー
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 関数(SQL の場合)を含む 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 は、残りの定義を含む名前プロパティをリポジトリがサポートしていることを示します。 サポートされている場合、項目定義の name 属性にはアスタリスク (「*」) を使用できます。
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 は、0 個以上の値を持つノードプロパティをリポジトリがサポートしていることを示します。
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 クラスターのプロパティと値を表すキーと値のペアのセット。テーブル内の各行にクラスタープロパティが 1 つずつ表示されます。読み取り専用。

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

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

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

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

操作

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

  • 引数:

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

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

  • 引数:

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

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

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

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

  • 引数:

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

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

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

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

  • 戻り値:なし

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

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

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

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

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

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

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

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

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

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

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

  • 引数:

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

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

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

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 週間の、1 時間あたりの測定値。読み取り専用。
  • ValuePerWeek:過去 3 年間の、1 週あたりの測定値。読み取り専用。

リポジトリクエリ統計

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

  • ドメイン: com.adobe.granite
  • 型:QueryStat

属性

SlowQueries 完了までの所要時間が最長だったリポジトリクエリに関する情報。読み取り専用。

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

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

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

操作

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

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

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

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

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

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

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

属性

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

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

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

読み取り専用。

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

  • true:有効。
  • false:無効。

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

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

読み取り専用。

QueuePaused ジョブキューが一時停止しているかどうかを示すブール値。

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

読み取り/書き込み。

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

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

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

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

QueueLastProcessTime 前回のジョブの完了日を示す Date 値。読み取り専用。

操作

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

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

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

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

Sling エンジン

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

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

属性

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

MinRequestDurationMsec 統計が最後にリセットされた以降に要求の処理に要した最短時間(ミリ秒単位)。

MaxRequestDuratioMsec 統計が最後にリセットされた以降に要求の処理に要した最長時間(ミリ秒単位)。

StandardDeviationDurationMsec 要求の処理に要した時間の標準偏差。標準偏差は、統計が最後にリセットされた以降のすべての要求を使用して計算されます。

MeanRequestDurationMsec 1 つの要求の処理に要した平均時間。平均は、統計が最後にリセットされて以降のすべての要求を使用して計算されます。

運用

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

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

id パッケージ ID の文字列表現。

installed パッケージがインストールされているかどうかを示す boolean 値。

  • true:インストールされています。
  • false:インストールされていません。

installedBy パッケージを最後にインストールしたユーザーの ID。

installedDate パッケージが最後にインストールされた日付。

size パッケージのサイズ(バイト数)を保持する long 値。

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

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

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

運用

log

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

引数:

  • p1: 表示するメッセージを表す String 値。
  • 戻り値:なし

startupFinished

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

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

startupProgress

サーバー起動プロセスの完了値を設定します。 クイックスタートウィンドウのプログレスバーは、完了値を表します。

  • 引数:
    • p1:起動プロセスが完了した割合を分数で表す浮動小数値。 値は 0 ~ 1 の範囲で指定する必要があります。 例えば、0.3 は 30%完了したことを示します。
  • 戻り値:なし.

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

いくつかのサードパーティサーバーリソースが、属性と操作を JMX コンソールに公開する MBean をインストールします。 次の表に、サードパーティのリソースと、その他の情報へのリンクを示します。

ドメイン タイプ MBean クラス
JMImplementation MBeanServerDelegate javax.management.MBeanServerDelegate
com.sun.management HotSpotDiagnostic com.sun.management.HotSpotDiagnosticMXBean
java.lang
  • ClassLoading
  • コンパイル
  • GarbageCollector
  • メモリ
  • MemoryManager
  • MemoryPool
  • OperatingSystem
  • Runtime
  • スレッド化
javax.management パッケージ
java.util.logging java.util.logging.LoggingMXBean
osgi.core
  • bundleState
  • フレームワーク
  • 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 を使用すると、外部アプリケーションがを介して管理 Beans(MBean) とやり取りできます。 Java 管理拡張 (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

このページ