summaryrefslogtreecommitdiff
path: root/doc/book/src/java-broker/Qpid-Management-Features.xml
blob: c90d7e97c680d05d6c4384f820a6663eee370e2e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
<?xml version="1.0" encoding="utf-8"?>
<!--
 
 Licensed to the Apache Software Foundation (ASF) under one
 or more contributor license agreements.  See the NOTICE file
 distributed with this work for additional information
 regarding copyright ownership.  The ASF licenses this file
 to you under the Apache License, Version 2.0 (the
 "License"); you may not use this file except in compliance
 with the License.  You may obtain a copy of the License at
 
   http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing,
 software distributed under the License is distributed on an
 "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 KIND, either express or implied.  See the License for the
 specific language governing permissions and limitations
 under the License.
 
-->

<section>
  <title>
      Qpid Management Features
    </title>
  <para>
            <emphasis>Management tool:</emphasis> See our <xref linkend="qpid_Qpid-JMX-Management-Console"/> for
            details of how to use various console options with the Qpid
            management features.
          </para>
  <para>
            The management of QPID is categorised into following types-
          </para>
  <orderedlist>
            <listitem><para>Exchange
            </para></listitem>
            <listitem><para>Queue
            </para></listitem>
            <listitem><para>Connection
            </para></listitem>
            <listitem><para>Broker
            </para></listitem>
          </orderedlist>
  <para>
             <emphasis>1) Managing and Monitoring Exchanges</emphasis>: Following is
            the list of features, which we can have available for managing
            and monitoring an Exchange running on a Qpid Server Domain-
          </para>
  <orderedlist>
            <listitem><para>Displaying the following information for monitoring purpose-
              <orderedlist>
                <listitem><para>The list of queues bound to the exchange along with the
                routing keys.
                </para></listitem>
                <listitem><para>
                  General Exchange properties(like name,
                  durable etc).
                </para></listitem>
              </orderedlist>
            </para></listitem>
            <listitem><para>
              Binding an existing queue with the
              exchange.
            </para></listitem>
          </orderedlist>
  <para>
            <emphasis>2) Managing and Monitoring
            Queues</emphasis>:  Following are the
            features, which we can have for a Queue on a Qpid Server
            Domain-
          </para>
  <orderedlist>
            <listitem><para>
              Displaying the following information about
              the queue for monitoring purpose-
              <orderedlist>
                <listitem><para>
                  General Queue properties(like name,
                  durable, etc.)
                </para></listitem>
                <listitem><para>
                  The maximum size of a message that can
                  be accepted from the message producer.
                </para></listitem>
                <listitem><para>
                  The number of the active consumers
                  accessing the Queue.
                </para></listitem>
                <listitem><para>
                  The total number of
                  consumers (Active and Suspended).
                </para></listitem>
                <listitem><para>
                  The number of undelivered messages
                  in the Queue.
                </para></listitem>
                <listitem><para>
                  The total number of messages received
                  on the Queue since startup.
                </para></listitem>
                <listitem><para>
                  The maximum number of bytes for
                  the Queue that can be stored on the Server.
                </para></listitem>
                <listitem><para>The maximum number of messages for the Queue that can be
                stored on the Server.
                </para></listitem>
              </orderedlist>
            </para></listitem>
            <listitem><para>
              Viewing the messages on the Queue.
            </para></listitem>
            <listitem><para>
              Deleting message from top of the
              Queue.
            </para></listitem>
            <listitem><para>
              Clearing the Queue.
            </para></listitem>
            <listitem><para>
              Browsing the DeadMessageQueue - Messages
              which are expired or undelivered because of some reason are
              routed to the DeadMessageQueue.  This queue can not be
              deleted.  [Note: The is open because it depends on how
              these kind of messages will be handeled?]
            </para></listitem>
          </orderedlist>
  <para>
            <emphasis>3) Managing and Monitoring
            Connections</emphasis>: Following are the
            features, which we can have for a connection on a QPID
            Server Domain-
          </para>
  <orderedlist>
            <listitem><para>
              Displaying general connection
              properties(like remote address, etc.).
            </para></listitem>
            <listitem><para>Setting maximum number of channels allowed for a
            connection.
            </para></listitem>
            <listitem><para>View all related channels and channel properties.
            </para></listitem>
            <listitem><para>Closing a channel.
            </para></listitem>
            <listitem><para>Commit or Rollback transactions of a channel, if the channel
            is transactional.
            </para></listitem>
            <listitem><para>Notification for exceeding the maximum number of
            channels.
            </para></listitem>
            <listitem><para>Dropping a connection.
            </para></listitem>
            <listitem><para>The work for <xref linkend="qpid_Network-IO-Interface"/> implies that
            there are potentially some additional requirements
              <orderedlist>
                <listitem><para>Alert when tcp flow control kicks in
                </para></listitem>
                <listitem><para>Information available about current memory usage
                available through JMX interface
                </para></listitem>
                <listitem><para>Dynamic removal of buffer bounds? (fundamentally not
                possible with TransportIO)
                </para></listitem>
                <listitem><para>Management functionality added to JMX interface - UI
                changes?
                </para></listitem>
              </orderedlist>
            </para></listitem>
          </orderedlist>
  <para>
            <emphasis>4) Managing the Broker</emphasis>: Features for the Broker-
          </para>
  <orderedlist>
            <listitem><para>Creating an Exchange.
            </para></listitem>
            <listitem><para>Unregistering an Exchange.
            </para></listitem>
            <listitem><para>Creating a Queue.
            </para></listitem>
            <listitem><para>Deleting a Queue.
            </para></listitem>
          </orderedlist>
</section>