Monitors

Intro
Installation
SysAdmin 
HTTP 
Logs 
Protection 
Security 
Intercept 
Scalability 
Alerts 
Events 
CLI/API 
Monitors
Network
Objects
Transfer
Access
Services
Directory
Data Files
Clusters
WebApp
WebMail
Miscellaneous
HowTo
HelpMe
Licensing

The CommuniGate Pro WebAdmin Interface allows Server Administrators to monitor activity of the server components in real-time.

To access the Monitors section of the WebAdmin Interface, click the Monitors icon in the left frame of the WebAdmin Interface page. To open pages in the Monitors "realm", you need to have the Monitors Access Right.

The Monitors realm includes pages that allow you to browse the Server Logs. See the Logs section of the manual for more details.

The Monitors realm includes pages that allow you to monitor activity of various CommuniGate Pro Transfer and Access modules. See the manual sections that describe those modules for more details. The Transfer-type modules process Queues. All module queues can be monitored using similar pages, see the Monitoring a Queue section below.

The Monitors realm includes pages that allow you to monitor statistical elements. See the SNMP section of the manual for more details.

Monitoring a Queue

Transfer modules (such as SMTP, Local Delivery, LIST, and PIPE maintain one or several queues for messages to be delivered. Each module uses its own methods to build the queues (for example, the SMTP module usually builds a separate queue for each remote domain to deliver to, while the Local Delivery module builds a separate queue for each local Account), see the manual section describing the module for more details.

To open a module queue, click the queue name link on module Monitor page. The module ("host") queue page opens:

Status Last Error Module Messages
Delayed till 21:03:30 some.domain.dom: no response SMTP 3
Message In Queue Return Path Addrs Size Delayed Last Error
263243362days<>11143
2632514629hours<>1114324:56:12Return-Path rejected: cannot resolve
263263405hours<>11143

The table header contains the information about the entire queue ("host"):

Status
Active - this queue is being processes by the module.
Ready - this queue can be processes by the module at any time.
Delayed till time - this queue will not be processes by the module until the time specified. The queue can be delayed because there was a queue-wide transfer operation error (an SMTP host did not respond, or a Local Account is over its quota, etc.).
Last Error
This field indicates the last queue-wide transfer operation error.
Module
The link to the Monitor page of the Transfer module this queue belongs to.
Messages
The number of messages in this queue.

The table contains a record for each message in the queue. For each enqueued message, the following information fields are displayed:

Message
The message internal ID. You can use this link to open the Message Monitor page.
In Queue
The time the message has spent in this queue.
Return Path
The message envelope "Return-Path" address.
Addrs
The number of message addresses that should be delivered to the "host" this queue is created for. For example, a message directed to user1@company.dom and user2@company.dom addresses via SMTP will appear once in the company.dom SMTP queue, with the indicated number of addresses being 2.
Size
The message size.
Delayed and Last Error
If delivery failed for this particular message, the Transfer module could delay this message individually (rather than delaying the entire queue). In this case, this field will show the time when the module will try to deliver the message again, and the Last Error field will show the information about the cause of the transfer operation failure.

If you have the Can Release Queues access right, and the Queue has the Delayed status, the Host Queue Monitor page contains the Release Now button. Click this button to remove the delay interval set for this queue and to allow the module to process the queue immediately.

If you have the Can Reject Queues access right, and the Queue has the Delayed or Ready status, the Host Queue Monitor page contains the Reject Host Queue button. Click this button to reject the queue:

The specified text is used to generate error reports for all messages placed into this queue.


Monitoring a Message

To monitor the status of a message in the Server Queue, click the message link on the Module queue or other Monitor page. The Message Monitor page opens:
Return-Path:<CGatePro-report@mail.stalker.com>
Message-ID:<list-26325892@mail.stalker.com>
Envelope-ID:
Subject:Re: FormMail.pl configured for CGP
Size:37222 bytes (34018 in envelope)
Submitted:Mon, 30 Dec 2002 09:16:58 -0800 (12hours ago)
Recipient Module Host Status Retry In
postmaster@domain1.domSMTPdomain1.domDelayed24min
john.smith@domain2.domSMTPdomain2.domDelayed57min
The first part of the page shows the message attributes: the envelope Return-Path, Message-ID, Envelope-ID (if present), message Subject, and the time the message was submitted to the Server Queue.

The second part of the page lists all active message recipient addresses (if a message address has been already processed, it is not shown). For each address the following information is displayed:

Recipient
Recipient address.
Module
The name of the module that will process this address. This is also a link to the module Monitor page.
Host
The name of the module queue containg this address. This is also a link to the module queue Monitor page.
Status
Processing - the module is processing this address.
Ready - the module can start processing of this address at any time.
Suspended - the module has delayed processing of this message.
Delayed - the module has delayed processing of the entire queue containing this address.
Retry In
Time till the module resumes processing of this message or the queue containing this message.

If you have the Can Reject Queues access right, the Message Monitor page contains the Reject Message button. Click this button to reject all active message addresses.

Only the addresses that are not being processed can be rejected.

The specified text is used to generate error reports for all rejected recipient addresses.


CommuniGate® Pro Guide. Copyright © 1998-2005, Stalker Software, Inc.