You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@activemq.apache.org by "Lionel Cons (JIRA)" <ji...@apache.org> on 2017/08/02 12:09:00 UTC

[jira] [Reopened] (ARTEMIS-405) JMX attributes should be documented

     [ https://issues.apache.org/jira/browse/ARTEMIS-405?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Lionel Cons reopened ARTEMIS-405:
---------------------------------

I've tried again today with {{apache-artemis-2.3.0-20170801.204113-14-bin.tar.gz}} and I see new undocumented attributes:
{code}
$ jmx4perl http://localhost:8161/jolokia list | grep "Attribute exposed for management"
            MaxDebugEntries                     int, "Attribute exposed for management"
            Debug                               boolean, "Attribute exposed for management"
            HistoryMaxEntries                   int, "Attribute exposed for management"
            HistorySize                         int [ro], "Attribute exposed for management"
            MaxDebugEntries                     int, "Attribute exposed for management"
            Debug                               boolean, "Attribute exposed for management"
            HistoryMaxEntries                   int, "Attribute exposed for management"
            HistorySize                         int [ro], "Attribute exposed for management"
            MaxDebugEntries                     int, "Attribute exposed for management"
            Debug                               boolean, "Attribute exposed for management"
            HistoryMaxEntries                   int, "Attribute exposed for management"
            HistorySize                         int [ro], "Attribute exposed for management"
            MaxDebugEntries                     int, "Attribute exposed for management"
            Debug                               boolean, "Attribute exposed for management"
            HistoryMaxEntries                   int, "Attribute exposed for management"
            HistorySize                         int [ro], "Attribute exposed for management"
            UploadDirectory                     java.lang.String [ro], "Attribute exposed for management"
            Domain                              java.lang.String [ro], "Attribute exposed for management"
            Scripts                             [Ljava.lang.String; [ro], "Attribute exposed for management"
            Name                                java.lang.String [ro], "Attribute exposed for management"
            Context                             java.lang.String [ro], "Attribute exposed for management"
            UpdateCounter                       long [ro], "Attribute exposed for management"
            HawtioVersion                       java.lang.String [ro], "Attribute exposed for management"
            Counter                             long [ro], "Attribute exposed for management"
            Domain                              java.lang.String [ro], "Attribute exposed for management"
            Scripts                             [Ljava.lang.String; [ro], "Attribute exposed for management"
            Name                                java.lang.String [ro], "Attribute exposed for management"
            Context                             java.lang.String [ro], "Attribute exposed for management"
{code}

Could these be documented too?

Also, it would be nice to have a process in place to make sure all new attributes get documented...

> JMX attributes should be documented
> -----------------------------------
>
>                 Key: ARTEMIS-405
>                 URL: https://issues.apache.org/jira/browse/ARTEMIS-405
>             Project: ActiveMQ Artemis
>          Issue Type: Improvement
>    Affects Versions: 1.2.0
>            Reporter: Lionel Cons
>            Assignee: Justin Bertram
>            Priority: Minor
>             Fix For: 1.3.0, 1.4.0
>
>
> Using Jolokia, it is very easy to list all the attributes exposed by Artemis: 
> {code}
> $ jmx4perl http://localhost:8161/jolokia/ list 'org.apache.activemq.artemis:brokerName="0.0.0.0",module=JMS,name="DLQ",serviceType=Queue,type=Broker' 
> org.apache.activemq.artemis:brokerName="0.0.0.0",module=JMS,name="DLQ",serviceType=Queue,type=Broker: 
> ===================================================================================================== 
> Attributes: 
>     Name                                java.lang.String [ro], "Attribute exposed for management" 
>     ExpiryAddress                       java.lang.String [ro], "Attribute exposed for management" 
>     RegistryBindings                    [Ljava.lang.String; [ro], "Attribute exposed for management" 
>     DeliveringCount                     int [ro], "Attribute exposed for management" 
>     Address                             java.lang.String [ro], "Attribute exposed for management" 
>     Selector                            java.lang.String [ro], "Attribute exposed for management" 
>     ScheduledCount                      long [ro], "Attribute exposed for management" 
>     MessageCount                        long [ro], "Attribute exposed for management" 
>     Paused                              boolean [ro], "Attribute exposed for management" 
>     DeadLetterAddress                   java.lang.String [ro], "Attribute exposed for management" 
>     FirstMessageTimestamp               java.lang.Long [ro], "Attribute exposed for management" 
>     ConsumerCount                       int [ro], "Attribute exposed for management" 
>     MessagesAdded                       long [ro], "Attribute exposed for management" 
>     FirstMessageAge                     java.lang.Long [ro], "Attribute exposed for management" 
>     Temporary                           boolean [ro], "Attribute exposed for management" 
>     FirstMessageAsJSON                  java.lang.String [ro], "Attribute exposed for management" 
> Operations: 
>     int retryMessages()                 "Retry all messages on a DLQ to their respective original queues" 
>     java.lang.String listMessageCounterHistory() "List the message counters history" 
>     java.lang.String listMessageCounterHistoryAsHTML() "List the message counters history as HTML" 
>     java.util.Map listDeliveringMessages() "List all messages being delivered per consumer" 
> [...] 
> {code}
> As you see, the operations are documented but not the attributes. They should be.



--
This message was sent by Atlassian JIRA
(v6.4.14#64029)