User Guide Cancel

Manage and monitor Adobe Connect server logs

Last updated on 18 January 2022 | Also applies to Adobe Connect 10, Adobe Connect 9

Read to configure logging on, know the log files of, and understand the log file format of an Adobe Connect server.

About log files

Use Adobe Connect log files to view information about events that occur during operation. You can use the information in the log files to create monitoring mechanisms and reports, and to troubleshoot problems. Log files provide information about user activities and server performance. For example, log files can indicate the reason a user was denied access when attempting to log in, or the reason that a telephony connection failed.

Adobe Connect log files are in the RootInstallationFolder\logs folder.

The Apache Tomcat log files are in the RootInstallation\logs\tomcat folder.

Configuring log files

Adobe Connect uses the Apache log4j tool. Use the file RootInstallationFolder\appserv\conf\log4j.xml to configure logging. For more information, see Log4j XML Configuration Primer.

To configure log appender, use the details provided at the DailyRollingFileAppender page.

Sample log file entry

The following sample entry from the access.log file includes a heading, a list of the fields used in the log entry, and the specific data for this log entry:

#Version: 1.0 
#Start-Date: 2010-10-30 17:09:24 PDT 
#Software: Adobe Connect Server 
#Date: 2010-04-30 
#Fields: date time x-comment x-module x-status x-severity x-category x-user x-access-request time-taken db-logical-io db-transaction-update-count                     
2006-10-30 18:12:50 Not logged in. PRINCIPAL NO_ACCESS_NO_LOGIN W A PUBLIC {cookie=breezxnb5pqusyshfgttt, ip=138.1.21.100} GET http://joeuser.adobe.com&mode=xml 0 20/5 0

The following table explains the sample entry:

Field	Data	Description
date	2010-10-30	The date on which the logged event occurred.
time	18:12:50	The time when the logged event occurred.
x-comment	Not logged in.	Indicates that a user was unable to log in to the application server.
x-module	PRINCIPAL	The event occurred in the Principal module in the application server.
x-status	NO_ACCESS_NO_LOGIN	Indicates that the user was unable to log in.
x-severity	W	Identifies the event severity as a warning (W).
x-category	A	Indicates that the event is an access (A) issue (appearing in the access.log file).
x-user	PUBLIC	The current user; in this case, an unidentified guest, or public user.
x-access-request	http://joeuser.adobe.com&mode=xml	Source of the request.
time-taken	0	No time was required to process this request.
db-logical-io	20/5	20 database reads were required and 5 rows of data were returned.
db-transaction-update-count	0	No database rows were updated in processing this request.

Log file format

The Adobe Connect log files use the W3C Extended Log File Format and you can use any text editor to read them. For information about AEM log files, see Configure AEM logging.

Log fields in the access.log and error.log files

Each log entry contains 11 log fields, which provide information about what type of event occurred, where it occurred, its severity, and other relevant data:

Field	Format	Description
date	YYYY/MM/DD	Date on which transaction completed.
time	HH:MM:SS	Local computer time at which transaction completed.
x-comment	String	Contains human-readable information about the log entry. This field is always output as the leftmost field.
x-module	String	Indicates where the error occurred.
x-status	String	Indicates what event occurred.
x-severity	Text (one character)	Indicates whether the logged event is critical (C), error (E), warning (W), or information (I).
x-category	Text (one character)	Indicates whether the log entry represents an access (A) or system (S) event.
x-user	String	Text that represents current user. Applicable only if x-category is access (A); otherwise field is set to a single hyphen (-) to denote an unused field.
x-access-request	String	Text that represents the access request. This text can be a URL or an API name with passed parameters. Applicable only if x-category is access (A); otherwise this field is set to a single hyphen (-) to denote an unused field.
time-taken	Number	Time required to process the request (in seconds). Applicable only if x-category is access (A); otherwise this field is set to a single hyphen (-) to denote an unused field.
db-logical-io	String	Number of database reads required to process the request and the number of rows returned in <reads>/<rows> format.
db-transaction-update-count	String	Number of rows updated in transactions while processing the requests. If the request uses more than one transaction, this value is the sum of all updates.

Module field entries

A module is a component of the server that manages some related set of operations. Each module belongs to either the application server or the meeting server. The x-module field indicates where the log event occurred:

Log Entry for x-module Field	Description	Server
ACCESS_KEY	Manages access keys.	Application server
ACCOUNT	Manages account operations.	Application server
ACL	Manages ACL-related operations.	Application server
AICC	Manages all AICC communication between server and content.	Application server
BUILDER	Performs SCO builds.	Application server
Client	Client methods.	Meeting server
CLUSTER	Manages all cluster-related operations.	Application server
CONSOLE	Manages all console-related operations.	Application server
Content	Share pod.	Meeting server
DB	Represents the database.	Application server
EVENT	Manages all event-related operations.	Application server
HOSTED_MANAGER	Manages system accounts (create, update, delete, settings, and so on).	Application server
MEETING	Manages all meeting-related operations.	Application server
Misc	Miscellaneous module.	Meeting server
NOTIFICATION	Manages all email operations.	Application server
PERMISSION	Manages all permission-related operations.	Application server
Poll	Poll pod.	Meeting server
PLATFORM_FRAMEWORK	Represents the platform framework.	Application server
PRINCIPAL	Manages all principal-related operations.	Application server
REPORT	Represents reports.	Application server
Room	Manages meeting room startup and shutdown.	Meeting server
RTMP	Represents RTMPHandler.	Application server
SCO	Manages all SCO-related operations.	Application server
SEARCH	Manages all search-related operations.	Application server
START_UP	Represents the startup component.	Application server
TELEPHONY	Manages all telephony-related operations.	Application server
TRACKING	Manages all transcript-related operations.	Application server
TRAINING	Manages all training-related operations.	Application server

Comment and status field entries

The x-comment field and the x-status field indicate what type of event occurred. The x-status field provides a code for each logged event. The x-comment field provides a human-readable description of each logged event.

The following table lists the status codes, the comment associated with each status code, and an explanation of each logged event:

Log Entry for x-status Field	Log Entry for x-comment Field	Description
ACCESS_DENIED	Client trying to access protected method. Access is denied. {1}	Logged when client attempts to access protected method.
BECAME_MASTER	Server {1} has been designated the master.	Logged when the scheduler quits and this server becomes the scheduler.
CLUSTER_CON_BROKEN	Server {1} unable to reach {2} on port {3} to perform cluster operations.	Logged when Adobe Connect is unable to reach another server in the cluster.
CLUSTER_FILE_TRANSFER_ERROR	Unable to transfer {1} from server {2}.	Logged when an error is thrown while transferring a file.
CONNECT	New client connecting: {1}	Logged when new client connects.
CONNECT_WHILE_GC	Connecting while the application is shutting down - forcing shutdown.	Logged when client attempts to connect while application is shutting down.
DB_CONNECTION_ERROR	Unable to connect to database {1}.	Logged when Adobe Connect cannot reach the database.
DB_CONNECTION_TIME_OUT	Timed out waiting for database connection.	Logged when database connection takes too long.
DB_VERSION_ERROR	Database {1} is incompatible with the current version of Adobe Connect.	Logged when the database is out-of-date.
DISCONNECT	A client is leaving. Details: {1}	Logged when client disconnects.
EXT_ERROR	External error thrown by a third party.	Logged when external code threw an error.
FMS_CON_BROKEN	Health check failed due to broken AMS service connection.	Logged when service connection is severed.
FMS_NOT_FOUND	Unable to connect to AMS at startup.	Logged when Adobe Connect is unable to establish the service connection at startup.
INTERNAL_ERROR	Internal error occurred.	Logged when internal error is thrown.
INVALID	-	Logged when invalid operation is attempted.
INVALID_DUPLICATE	Value {1} is a duplicate in the system.	Logged when value entered duplicates a value in the system.
INVALID_FORMAT	Field {1} of type {2} is invalid.	Value specified is invalid for this field.
INVALID_ILLEGAL_OPERATION	Illegal operation performed.	Requested operation is not legal.
INVALID_ILLEGAL_PARENT	-	Logged when an ACL has an invalid parent. For example, if folder A is inside folder B, folder B cannot be in folder A.
INVALID_MISSING	Field {1} of type {2} is missing.	Missing required value for this field.
INVALID_NO_SUCH_ITEM	Value {1} is an unknown in the system.	Requested item does not exist.
INVALID_RANGE	The specified value must be between {1} and {2}.	Logged when value entered is out of range.
INVALID_TELEPHONY_FIELD	Service provider did not validate the telephony authentication values.	Service provider unable to validate telephony account.
INVALID_VALUE_GTE	The specified value must be greater than or equal to {1}.	Logged when value entered is out of range.
INVALID_VALUE_LTE	The specified value must be less than or equal to {1}.	Logged when value entered is out of range.
KILLING_LONG_CONNECTION	Client has been in the room for 12 hours, disconnecting.	Logged when client connection is terminated after time limit is reached.
LICENSE_EXPIRED	Your license has expired and your account will be disabled on {1}. Please upload a new license file through the console manager to continue using Adobe Connect.	Logged when customer is using Adobe Connect during grace period and access is about to be cut off.
LICENSE_EXPIRY_WARNING	Your license will expire on {1}. Please upload a new license file through the console manager to continue using Adobe Connect.	Logged when license is 15 days or fewer from expiring.
MASTER_THREAD_TIMED_OUT	Master thread has not reported progress in {1} milliseconds.	Scheduler thread not running.
MEETING_BACKUP_END	Server {1} is no longer the backup for room {2}.	Meeting backup has ended.
MEETING_BACKUP_START	Server {1} is now the backup for room {2}.	Meeting backup has started.
MEETING_FAILOVER	Meeting {1} failed over to {2}.	Logged when a meeting fails over to this server.
MEETING_TMP_READ	Meeting template {1} read for room {2}.	Template read from meeting.
MEETING_TMP_WRITTEN	Meeting template {1} written to room {2}.	Template written to meeting.
NO_ACCESS_ACCOUNT_EXPIRED	Your account has expired.	Accessed account has expired.
NO_ACCESS_DENIED	Permission check failed.	Permission check error.
NO_ACCESS_LEARNER	No permission to take courses.	Must be a member of the learner group to take a course.
NO_ACCESS_LEARNING_PATH_BLOCKED	You have not fulfilled a prerequisite or preassessment.	Prerequisite or preassessment error.
NO_ACCESS_NO_EXTERNAL_USER_MODIFICATION	External users cannot be modified.	User is not allowed to modify LDAP users.
NO_ACCESS_NO_LICENSE_FILE	Your license file has not been uploaded.	License file not found.
NO_ACCESS_NO_LOGIN	Not logged in.	Error thrown when user not logged in.
NO_ACCESS_NO_QUOTA	A {1} quota error occurred for account {2} with limit {3}.	Out of quota.
NO_ACCESS_NO_RETRY	You have reached the max limit and cannot take the course again.	User has exceeded course retry limit.
NO_ACCESS_NO_SERVER	Server not available	Requested server is not available.
NO_ACCESS_NOT_AVAILABLE	The requested resource is unavailable.	Logged when the requested resource is not available.
NO_ACCESS_NOT_SECURE	SSL request made on a non-SSL server.	Secure request made on non-secure server.
NO_ACCESS_PASSWORD_EXPIRED	Your password has expired.	Logged when a user password has expired.
NO_ACCESS_PENDING_ACTIVATION	Your account has not been activated yet.	Account is not activated yet.
NO_ACCESS_PENDING_LICENSE	Your account activation is pending a license agreement.	Account not usable until license agreement is read.
NO_ACCESS_SCO_EXPIRED	The course you tried to access is no longer available.	Course end date is passed.
NO_ACCESS_SCO_NOT_STARTED	Course is not open yet.	Course start date is not reached.
NO_ACCESS_WRONG_ZONE	Content accessed from wrong zone.	Thrown when content or user accesses a server in the wrong zone.
NO_DATA	Permission check failed.	Query did not return any data.
NO_DISKSPACE	Health check failed due to lack of disk space.	Logged when the account runs out of disk space.
NOT_AVAILABLE	Requested resource is not available.	Error thrown when resource is not available.
OK	-	Request successfully processed.
OPERATION_SIZE_ERROR	Operation too large to complete.	Logged when operation can’t be completed because of size.
REQUEST_RETRY	Unable to process request. Please try again.	The request failed.
RESPONSE_ABORTED	Client that made request is not available to receive response.	Logged when user closes browser before server can send response back.
RTMP_SVC_BLOCKED	Adobe Connect service request blocked from {1} because the server has not fully started up yet.	Service connection requested from SCO but the server is still starting.
RTMP_SVC_CLOSED	Adobe Connect service connection closed for {1}.	Service connection closed for SCO.
RTMP_SVC_REQUEST	Adobe Connect service request received from {1}.	Service connection requested from SCO.
RTMP_SVC_START	Adobe Connect service connection established with {1}.	Service connection established with SCO.
SCRIPT_ERROR	Run-Time Script Error. Details: {1}	Logged when script error is detected.
SERVER_EXPIRED	Health check failed due to server expiry (expiry date={1}, current time={2}).	Logged when server does not pass health check before timing out.
SOME_ERRORS_TERMINATED	Some actions terminated with an error.	Logged when an error causes some actions to terminate.
START_UP_ERROR	Start up error: {1}.	Logged when an exception is thrown during startup.
START_UP_ERROR_UNKNOWN	Unable to start up server. Adobe Connect might already be running.	Logged when an unknown error is thrown during startup. JRUN prints the error.
TEL_CONNECTION_BROKEN	Telephony connection {1} was unexpectedly broken.	Logged when the telephony connection breaks.
TEL_CONNECTION_RECOVERY	Telephony connection {1} was reattached to conference {2}.	Logged when Adobe Connect recovers a connection to the conference again.
TEL_DOWNLOAD_FAILED	Unable to download {1} for archive {2}.	Logged when time-out occurs while downloading telephony audio files.
TOO_MUCH_DATA	Multiple rows unexpectedly returned.	Logged when an operation returns more data than expected.
UNKNOWN_TYPE	{1}	Logged when variable type is unknown.

Note:

In the preceding table, {1} and {2} are variables that are replaced with a value in the log entry.

Severity field entries

The x-severity field indicates how serious a condition is, which helps you determine the appropriate response level.

Log Entry for x-severity	Meaning	Suggested Action	Example
C	Critical	Configure third- party monitoring tools to alert pagers when a log entry with this severity level occurs.	Can’t reach the database. Can't start or end a process. A failure is affecting the system.
E	Error	Configure third- party monitoring tools to send an email when a log entry with this severity level occurs.	Can't reach Adobe® Premiere®. Conversion failed. A failure is affecting a user or account, but not the whole system.
W	Warning	Generate and review periodic reports to identify possible operational and product improvements.	Disk or memory use has exceeded the specified threshold.
I	Info	Review log entries for auditing or RCA purposes.	Server started, stopped, or restarted.

Category field entries

The x-category field indicates whether the event relates to access issues (A) or general system issues (S). All entries of category A appear in the access.log file, and all entries of category S appear in the error.log file.

Log Entry for x-category field	Meaning	Description
A	access	Status code is related to access issues. Logged in access.log file.
S	system	Status code is related to general system issues. Logged in error.log file.

More like this

Adobe

Get help faster and easier

New user?