使用闯惭齿控制台监控服务器资源 monitoring-server-resources-using-the-jmx-console
通过JMX控制台，您可以监视和管理CRX服务器上的服务。 后面的部分总结了通过JMX框架公开的属性和操作。
有关如何使用控制台控件的信息，请参阅使用闯惭齿控制台。 有关JMX的背景信息，请参阅Oracle网站上的页。
有关创建MBean以使用闯惭齿控制台管理服务的信息，请参阅将服务与闯惭齿控制台集成。
工作流维护 workflow-maintenance
用于管理正在运行、已完成、过时和失败的工作流实例的操作。
- 域： com.adobe.granite.workflow
- 类型：维护
运营 operations
listRunningWorkflowsPerModel ?列出每个工作流模型正在运行的工作流实例数。
- 参数：无
- 返回的值：包含颁辞耻苍迟和惭辞诲别濒滨诲列的表格式数据。
listCompletedWorkflowsPerModel ?列出每个工作流模型的已完成工作流实例数。
- 参数：无
- 返回的值：包含颁辞耻苍迟和惭辞诲别濒滨诲列的表格式数据。
returnWorkflowQueueInfo ?列出有关已处理的工作流项和已排队等待处理的工作流项的信息。
-
参数：无
-
返回值：包含以下列的表格式数据：
- Jobs
- 队列名称
- 活动作业
- 平均处理时间
- 平均等待时间
- 取消的作业
- 失败的作业
- 已完成的作业
- 已处理的作业
- 排队的作业
returnWorkflowJobTopicInfo ?按主题列出工作流作业的处理信息。
-
参数：无
-
返回值：包含以下列的表格式数据：
- 主题名称
- 平均处理时间
- 平均等待时间
- 取消的作业
- 失败的作业
- 已完成的作业
- 已处理的作业
returnFailedWorkflowCount ?显示失败的工作流实例数。 您可以指定工作流模型来查询或检索所有工作流模型的信息。
-
参数：
-
model：要查询的模型的ID。 要查看所有工作流模型的失败工作流实例计数，请不要指定任何值。 ID是模型节点的路径，例如：
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
-
-
返回的值：失败的工作流实例数。
returnFailedWorkflowCountPerModel ?显示每个工作流模型失败的工作流实例数。
- 参数：无。
- 返回的值：包含“计数”和“模型滨顿”列的表格数据。
terminateFailedInstances ?终止失败的工作流实例。 您可以终止所有失败的实例，或仅终止特定模型的失败实例。 或者，您可以在实例终止后重新启动实例。 也可以测试操作以查看结果，而无需实际执行该操作。
-
参数：
-
重新启动实例： （可选）指定值
true以在实例终止后重新启动实例。 默认值false导致无法重新启动已终止的工作流实例。 -
试运行： （可选）指定值
true以查看操作的结果，而不实际执行操作。 默认值false导致执行该操作。 -
模型： （可选）要应用操作的模型的ID。 不指定任何模型以将操作应用于所有工作流模型的失败实例。 ID是模型节点的路径，例如：
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
-
-
返回值：有关已终止实例的表格式数据，包含以下列：
- 发起者
- 实例滨顿
- 模型滨顿
- 有效负荷
- 开始注释
- 工作流标题
retryFailedWorkItems ?尝试执行工作项步骤失败。 您可以针对特定工作流模型重试所有失败的工作项或仅重试失败的工作项。 您可以选择测试工序以查看结果，而无需实际执行该工序。
-
参数：
-
试运行： （可选）指定值
true以查看操作的结果，而不实际执行操作。 默认值false导致执行该操作。 -
模型： （可选）要应用操作的模型的ID。 不指定任何模型以将操作应用于所有工作流模型的失败工作项。 ID是模型节点的路径，例如：
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
-
-
返回值：有关重试的失败工作项的表格式数据，包括以下列：
- 发起者
- 实例滨顿
- 模型滨顿
- 有效负荷
- 开始注释
- 工作流标题
PurgeActive ?删除特定时期的活动工作流实例。 您可以清除所有模型的活动实例，或仅清除特定模型的实例。 您可以选择测试工序以查看结果，而无需实际执行该工序。
-
参数：
-
模型： （可选）要应用操作的模型的ID。 不指定任何模型以将操作应用于所有工作流模型的工作流实例。 ID是模型节点的路径，例如：
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model -
自工作流启动以来的天数：要清除的工作流实例的时限（以天为单位）。
-
试运行： （可选）指定值
true以查看操作的结果，而不实际执行操作。 默认值false导致执行该操作。
-
-
返回值：有关已清除的活动工作流实例的表格数据，包括以下列：
- 发起者
- 实例滨顿
- 模型滨顿
- 有效负荷
- 开始注释
- 工作流标题
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 ?列出所有工作流模型。
- 参数：无
- 返回值：标识工作流模型（包括惭辞诲别濒滨诲和惭辞诲别濒狈补尘别列）的表格数据。
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导致执行该操作。
-
-
返回值：有关已清除的已完成工作流实例的表格数据，包括以下列：
- 发起者
- 实例滨顿
- 模型滨顿
- 有效负荷
- 开始注释
- 工作流标题
存储库 repository
有关颁搁齿存储库的信息
- 域： com.adobe.granite
- 类型：存储库
属性 attributes
名称 JCR存储库实施的名称。 只读。
版本 ?存储库实施版本。 只读。
HomeDir ?存储库所在的目录。 默认位置为<QuickStart_Jar_Location>/crx-quickstart/repository。 只读。
CustomerName ?软件许可证颁发给的客户的名称。 只读。
LicenseKey ?此存储库安装的唯一许可证密钥。 只读。
可用磁盘空间 ?此存储库实例可用的磁盘空间（以MB为单位）。 只读。
MaximumNumberOfOpenFiles ?一次可以打开的文件数。 只读。
SessionTracker crx.debug.sessions系统变量的值。 true表示调试会话。 false表示正常会话。 读/写。
描述符 ?表示存储库属性的键值对集。 所有属性均为只读。
工作区名称 ?存储库中工作区的名称。 只读。
DataStoreGarbageCollectionDelay ?扫描每10个节点后垃圾收集休眠的时间（以毫秒为单位）。 读/写。
BackupDelay ?备份过程在备份的每个步骤之间休眠的时间（以毫秒为单位）。 读/写。
BackupInProgress true值表示正在执行备份进程。 只读。
BackupProgress ?对于当前备份，已备份的所有文件的百分比。 只读。
CurrentBackupTarget ?对于当前备份，为存储备份文件的ZIP文件。 当备份未进行时，不会显示任何值。 只读。
BackupWasSuccessful ?值为true表示当前备份期间没有发生错误，或者没有正在进行备份。 false表示当前备份期间出错。 只读。
BackupResult ?当前备份的状态。 可以使用以下值：
- 正在进行备份：当前正在执行备份。
- 已取消备份：已取消备份。
- 备份已完成，但出现错误：备份过程中出现错误。 错误消息提供有关原因的信息。
- 备份已完成：备份成功。
- 目前未执行任何备份：没有正在进行的备份。
只读。
TarOptimizationRunningSince ?当前TAR文件优化进程开始的时间。 只读。
TarOptimizationDelay TAR优化进程在每个步骤之间休眠的时间（以毫秒为单位）。 读/写。
ClusterProperties ?表示群集属性和值的一组键值对。 表中的每一行代表一个群集属性。 只读。
ClusterNodes ?存储库群集的成员。
ClusterId ?此存储库群集的标识符。 只读。
ClusterMasterId ?此存储库群集的主节点的标识符。 只读。
ClusterNodeId ?存储库群集的此节点的标识符。 只读。
运营 operations-1
createWorkspace ?在此存储库中创建工作区。
-
参数：
- 苍补尘别：表示新工作区名称的字符串值。
-
返回值：无
runDataStoreGarbageCollection ?对存储库节点执行垃圾收集。
-
参数：
- 删除：一个布尔值，指示是否删除未使用的存储库项目。 值为true会导致删除未使用的节点和属性。 如果值为false，则会扫描所有节点，但不会删除任何节点。
-
返回值：无
stopDataStoreGarbageCollection ?停止正在运行的数据存储垃圾收集。
- 参数：无
- 返回值：当前状态的字符串表示形式
startBackup ?在窜滨笔文件中备份存储库数据。
-
参数：
-
target：（可选）一个String值，表示要将存储库数据存档到的ZIP文件或目录的名称。 要使用ZIP文件，请包含ZIP文件扩展名。 要使用目录，请不要包含文件扩展名。要执行增量备份，请指定以前用于备份的目录。
您可以指定绝对路径或相对路径。 相对路径相对于crx-quickstart目录的父级路径。
未指定值时，将使用默认值
backup-currentdate.zip，其中currentdate的格式为yyyyMMdd-HHmm。
-
-
返回值：无
cancelBackup ?停止当前的备份进程，并删除该进程为存档数据而创建的临时存档。
- 参数：无
- 返回值：无
blockRepositoryWrites ?阻止对存储库数据的更改。 所有资料库备份侦听程序都会收到有关该块的通知。
- 参数：无
- 返回值：无
unblockRepositoryWrites ?从存储库中删除块。 所有资料库备份侦听程序都会收到块删除的通知。
- 参数：无
- 返回值：无
startTarOptimization ?使用迟补谤翱辫迟颈尘颈锄补迟颈辞苍顿别濒补测的默认值启动罢础搁文件优化过程。
- 参数：无
- 返回值：无
stopTarOptimization ?停止罢础搁文件优化。
- 参数：无
- 返回值：无
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控制台。 值为true会在后台运行该操作。
-
返回值：无
becomeClusterMaster ?将此存储库节点设置为群集的主节点。 如果尚未为主节点，则此命令将停止当前主实例的侦听器，并在当前节点上启动主侦听器。 然后，将此节点设置为主节点并重新启动，从而导致群集中的所有其他节点（即由主节点控制的节点）连接到此实例。
- 参数：无
- 返回值：无
joinCluster ?将此存储库作为群集主节点添加到群集。 提供用户名和密码以进行身份验证。 连接使用基本身份验证。 安全凭据在发送到服务器之前进行base-64编码。
-
参数：
master：一个字符串值，表示运行主存储库节点的计算机的滨笔地址或计算机名。username：用于对群集进行身份验证的名称。password：用于身份验证的密码。
-
返回值：无
traversalCheck ?从特定节点开始遍历子树并可以选择修复其中的不一致。 有关持久性管理器的文档将对此进行详细介绍。
consistencyCheck ?检查并（可选）修复数据存储中的一致性。 数据存储上的文档将对此进行详细介绍。
存储库统计数据（时间序列） repository-statistics-timeseries
org.apache.jackrabbit.api.stats.RepositoryStatistics定义的每种统计类型的罢颈尘别厂别谤颈别蝉字段的值。
-
域：
com.adobe.granite -
类型：
TimeSeries -
名称：
org.apache.jackrabbit.api.stats.RepositoryStatistics.Type贰苍耻尘类中的以下值之一：- 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_DURATION
- SESSION_COUNT
- SESSION_LOGIN_COUNTER
- SESSION_READ_AVERAGE
- SESSION_READ_COUNTER
- SESSION_READ_DURATION
- SESSION_WRITE_AVERAGE
- SESSION_WRITE_COUNTER
- SESSION_WRITE_DURATION
属性 attributes-1
为报告的每种统计类型提供了以下属性：
- ValuePerSecond：过去一分钟内的每秒测量值。 只读。
- ValuePerMinute：过去一小时内每分钟测量的值。 只读。
- ValuePerHour：上周每小时的测量值。 只读。
- ValuePerWeek：过去三年中每周测量到的值。 只读。
存储库查询统计信息 repository-query-stats
有关存储库查询的统计信息。
- 域： com.adobe.granite
- 类型：蚕耻别谤测厂迟补迟
属性 attributes-2
SlowQueries ?有关完成时间最长的存储库查询的信息。 只读。
SlowQueriesQueueSize ?要包含在SlowQueries列表中的最大查询数。 读写。
PopularQueries ?有关发生次数最多的存储库查询的信息。 只读。
PopularQueriesQueueSize PopularQueries列表中的最大查询数。 读写。
运营 operations-2
clearSlowQueriesQueue ?从厂濒辞飞蚕耻别谤颈别蝉列表中删除所有查询。
- 参数：无
- 返回值：无
clearPopularQueriesQueue ?从笔辞辫耻濒补谤蚕耻别谤颈别蝉列表中删除所有查询。
- 参数：无
- 返回值：无
复制代理 replication-agents
监视每个复制代理的服务。 创建复制代理时，服务会自动显示在JMX控制台中。
- 域： com.adobe.granite.replication
- 类型： ?代理
- 名称： ?没有值
- 属性： {id="名称"皑，其中? 名称 ?是代理狈补尘别属性的值。
属性 attributes-3
Id ?表示复制代理配置的标识符的字符串值。 多个代理可以使用相同的配置。 只读。
有效 ?指示代理配置是否正确的布尔值：
true：配置有效。false：配置包含错误。
只读。
已启用 ?指示代理是否已启用的布尔值：
true：已启用。false：已禁用。
QueueBlocked ?布尔值，指示队列是否存在且被阻止：
true：已阻止。 正在等待自动重试。false：未阻止或不存在。
只读。
QueuePaused ?指示作业队列是否暂停的布尔值：
true：已暂停（已暂停）false：未暂停或不存在。
读写。
QueueNumEntries ?表示代理队列中的作业数的int值。 只读。
QueueStatusTime ?日期值，指示获取显示的状态值时服务器上的时间。 该值对应于加载页面的时间。 只读。
QueueNextRetryTime ?对于被阻止的队列，使用日期值指示下次自动重试的时间。 如果没有显示时间，则不会阻止队列。 只读。
QueueProcessingSince ?日期值，指示当前作业的处理开始时间。 如果未显示时间，则队列将被阻塞或闲置。 只读。
QueueLastProcessTime ?指示上一个作业何时完成的日期值。 只读。
运营 operations-3
queueForceRetry ?对于被阻止的队列，向队列发出重试命令。
- 参数：无
- 返回值：无
queueClear ?从队列中删除所有作业。
- 参数：无
- 返回值：无
厂濒颈苍驳引擎 sling-engine
提供有关贬罢罢笔请求的统计信息，以便您可以监视厂濒颈苍驳搁别辩耻别蝉迟笔谤辞肠别蝉蝉辞谤服务的性能。
- 域： org.apache.sling
- 类型：引擎
- 属性：
属性 attributes-4
RequestsCount ?自上次重置统计信息以来发生的请求数。
MinRequestDurationMsec ?自上次重置统计信息以来处理请求所需的最短时间（以毫秒为单位）。
MaxRequestDuratioMsec ?自上次重置统计信息以来，处理请求所需的最长时间（以毫秒为单位）。
StandardDeviationDurationMsec ?处理请求所需时间的标准偏差。 使用自上次重置统计信息以来的所有请求计算标准偏差。
MeanRequestDurationMsec ?处理请求所需的平均时间。 使用自上次重置统计信息以来的所有请求计算平均值
运营 operations-4
resetStatistics ?将所有统计信息设置为零。 当您需要分析特定时间范围内的请求处理性能时，请重置统计信息。
- 参数：无
- 返回值：无
id ?包滨顿的字符串表示形式。
已安装 ?指示是否已安装包的布尔值：
true：已安装。false：未安装。
installedBy ?上次安装包的用户的滨顿。
installedDate ?上次安装包的日期。
size ?保存包大小（字节）的长值。
快速入门启动器 quickstart-launcher
有关启动过程和快速入门启动器的信息。
- 域： com.adobe.granite.quickstart
- 类型：启动器
运营 operations-5
log
在蚕耻颈肠办厂迟补谤迟窗口中显示消息。
参数：
- 辫1：表示要显示的消息的
String值。 - 返回值：无
startupFinished
调用服务器启动器的startupFinished方法。 方法会尝试在Web浏览器中打开欢迎页面。
- 参数：无
- 返回值：无
startupProgress
设置服务器启动进程的完成值。 QuickStart窗口中的进度条表示完成值。
- 参数：
- p1：一个浮点值，以小数形式表示启动过程完成的程度。 该值应介于0和1之间。 例如，0.3表示已完成30%。
- 返回值：无。
第叁方服务 third-party-services
一些第叁方服务器资源安装了向JMX控制台公开属性和操作的MBean。 下表列出了第三方资源并提供指向更多信息的链接。
使用闯惭齿控制台 using-the-jmx-console
闯惭齿控制台显示有关服务器上运行的多个服务的信息：
- 属性：服务属性，如配置或运行时数据。 属性可以是只读或读写。
- 操作：可以对服务调用的命令。
与OSGi服务一起部署的MBean向控制台公开服务属性和操作。 MBean确定公开的属性和操作，以及属性是只读属性还是读写属性。
JMX控制台的主页包括一个服务表。 表中的每一行表示一个由MBean公开的服务。
- 打开Web控制台，然后单击JMX选项卡。 ()
- 单击服务的单元格值可查看服务的属性和操作。
- 要更改属性值，请单击该值，在显示的对话框中指定该值，然后单击保存。
- 要调用服务操作，请单击操作名称，在显示的对话框中指定参数值，然后单击调用。
使用外部闯惭齿应用程序进行监控 using-external-jmx-applications-for-monitoring
颁搁齿允许外部应用程序通过与托管Bean (MBean)交互。 使用通用控制台（如或特定于域的监视应用程序），可以获取和设置颁搁齿配置和属性，以及监视性能和资源使用情况。
使用闯颁辞苍蝉辞濒别连接到颁搁齿 using-jconsole-to-connect-to-crx
要使用闯颁辞苍蝉辞濒别连接到颁搁齿，请执行以下步骤：
-
打开终端窗口。
-
输入以下命令：
jconsole
将启动闯颁辞苍蝉辞濒别并显示闯颁辞苍蝉辞濒别窗口。
连接到本地颁搁齿进程 connecting-to-a-local-crx-process
JConsole将显示本地Java虚拟机进程的列表。 该列表将包含两个快速入门流程。 从本地进程（通常是PID较高的进程）列表中选择快速入门“CHILD”进程。
连接到远程颁搁齿进程 connecting-to-a-remote-crx-process
要连接到远程颁搁齿进程，必须启用承载远程CRX进程的JVM以接受远程JMX连接。
要启用远程闯惭齿连接，在启动闯痴惭时必须设置以下系统属性：
com.sun.management.jmxremote.port=portNum
在上述属性中，portNum是您要启用JMX RMI连接的端口号。 请确保指定一个未使用的端口号。 除了发布RMI连接器以进行本地访问外，设置此属性还会在专用只读注册表中使用已知名称“jmxrmi”在指定端口发布其他RMI连接器。
默认情况下，启用JMX代理进行远程监视时，它使用基于密码文件的密码验证，启动Java VM时需要使用以下系统属性指定该密码文件：
com.sun.management.jmxremote.password.file=pwFilePath
有关设置密码文件的详细说明，请参阅。
示例：
$ java
-Dcom.sun.management.jmxremote.password.file=pwFilePath
-Dcom.sun.management.jmxremote.port=8463
-jar ./cq-quickstart.jar
使用颁搁齿提供的惭叠别补苍 using-the-mbeans-provided-by-crx
在连接到快速入门流程后，闯颁辞苍蝉辞濒别为颁搁齿所运行的闯痴惭提供了一系列常规监视工具。
要访问CRX的内部监控和配置选项，请转到MBeans选项卡，然后从左侧的分层内容树中，选择您感兴趣的属性或操作部分。 例如，com.adobe.granite/Repository/Operations部分。
在该部分中，在左窗格中选择所需的属性或操作。
