6.5.4. < a4j:log > available since 3.0.0

### Create new RichFaces Documentation Jira issue

Summary
255 characters left
Description
Environment
This will launch the RichFaces Jira page - to complete your feedback please login if needed, and submit the Jira.

JBoss.org Community Documentation

- Prev
- Next

### 6.5.4. < a4j:log > available since 3.0.0

expand all

#### 6.5.4.1. Description

The <a4j:log > component generates JavaScript that opens a debug window with useful debug information.

#### 6.5.4.2. Details of Usage

The <a4j:log > component generates JavaScript that opens a log window with useful debug information, which contains data on requests and responses, DOM tree changes et al. The log could be generated not only in a new window, but also on the current page in a separate <div> element. This feature is controlled with the component "popup" attribute. The window is opened on pressing of "CTRL+SHIFT+L", which is default registered key. The hot key could be changed with the "hotkey" attribute, where it's necessary to define one letter that together with "CTRL+SHIFT" opens a window.

The "level" attribute has several possible values "FATAL", "ERROR", "WARN", "INFO", "ALL" and is used when it is necessary to change a logging level.

Example:

    <a4j:log level="ALL" popup="false" width="400" height="200"/>

The component defined this way is decoded on a page as <div> inside a page, where all the information beginning with informational message is generated.

## Note:

<a4j:log> is getting renewed automatically after execution of Ajax requests. Do not renew <a4j:log> by using reRender!

#### 6.5.4.3. Reference Data

Table of <a4j:log> attributes.

Table 6.29. Component Identification Parameters

Name | Value
--- | ---
component-type | org.ajax4jsf.Log
component-family | org.ajax4jsf.Log
component-class | org.ajax4jsf.component.html.AjaxLog
renderer-type | org.ajax4jsf.LogRenderer

#### 6.5.4.4. Relevant Resources Links

Visit the Log page at RichFaces LiveDemo for example of component usage and their sources.

You can find some cases when <a4j:log> might cause JavaScript error on Ajax Core Components Page.

- Prev6.5.3. < a4j:htmlCommandLink > ...
- Top of page
- Front page
- Next6.6. Data Iteration