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 2016/07/20 14:12:20 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 am sorry to re-open this issue but, using the latest snapshot, I see:

{code}
# jmx4perl http://localhost:60005/jolokia list 'org.apache.activemq.artemis:brokerName="artemis",module=JMS,name="test3",serviceType=Topic,type=Broker'
org.apache.activemq.artemis:brokerName="artemis",module=JMS,name="test3",serviceType=Topic,type=Broker:
=======================================================================================================

Attributes:
    DurableSubscriptionCount            int [ro], "Attribute exposed for management"
    MessageCount                        long [ro], "Attribute exposed for management"
    Address                             java.lang.String [ro], "Attribute exposed for management"
    NonDurableSubscriptionCount         int [ro], "Attribute exposed for management"
    NonDurableMessageCount              int [ro], "Attribute exposed for management"
    RegistryBindings                    [Ljava.lang.String; [ro], "Attribute exposed for management"
    Temporary                           boolean [ro], "Attribute exposed for management"
    SubscriptionCount                   int [ro], "Attribute exposed for management"
    DurableMessageCount                 int [ro], "Attribute exposed for management"
    DeliveringCount                     int [ro], "Attribute exposed for management"
    Name                                java.lang.String [ro], "Attribute exposed for management"
    MessagesAdded                       long [ro], "Attribute exposed for management"
Operations:
    java.lang.String listDurableSubscriptionsAsJSON() "List only the durable subscriptions"
    java.lang.String listAllSubscriptionsAsJSON() "List all subscriptions"
    void addBinding(java.lang.String binding) "Adds the queue to another Registry binding"
    int removeMessages(java.lang.String filter) "Remove messages matching the given filter from the destination"
    [Ljava.lang.Object; listAllSubscriptions() "List all subscriptions"
    void dropAllSubscriptions()         "Drop all subscriptions from this topic"
    java.lang.String listMessagesForSubscriptionAsJSON(java.lang.String queueName) "List all the message for the given subscription"
    java.lang.String listNonDurableSubscriptionsAsJSON() "List only the non durable subscriptions"
    [Ljava.lang.Object; listDurableSubscriptions() "List only the durable subscriptions"
    void dropDurableSubscription(java.lang.String clientID,java.lang.String subscriptionName) "Drop a durable subscription"
    int countMessagesForSubscription(java.lang.String clientID,java.lang.String subscriptionName,java.lang.String filter) "Count the number of messages matching the filter for the given subscription"
    [Ljava.util.Map; listMessagesForSubscription(java.lang.String queueName) "List all the message for the given subscription"
    [Ljava.lang.Object; listNonDurableSubscriptions() "List only the non durable subscriptions"
{code}

> 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
>
>
> 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.3.4#6332)