Logging in identity-related scripts
Identity-related logs can be used in scripts created for custom endpoints or script triggers.
Advanced Identity Cloud provides a logger object to access the Simple Logging Facade for Java (SLF4J) facilities. The following code shows an example of the logger object.
logger.info("Parameters passed in: {} {} {}", param1, param2, param3);In addition, JavaScript has a useful logging function named console.log(). This function provides an easy way to dump data to the Advanced Identity Cloud standard output (usually the same output as the OSGi console). The function works well with the JavaScript built-in function JSON.stringify and provides fine-grained details about any given object. For example, the following line will print a formatted JSON structure that represents the HTTP request details to STDOUT.
console.log(JSON.stringify(context.http, null, 4));The script engine supports the following log functions:
logger.debug(string message, object... params)
Logs a message at DEBUG level.
- Parameters
-
- message
-
string
The message format to log. Params replace
{}in your message. - params
-
object
Arguments to include in the message.
- Returns
-
A
nullvalue if successful. - Throws
-
An exception is thrown if the message could not be logged.
logger.error(string message, object... params)
Logs a message at ERROR level.
- Parameters
-
- message
-
string
The message format to log. Params replace
{}in your message. - params
-
object
Arguments to include in the message.
- Returns
-
A
nullvalue if successful. - Throws
-
An exception is thrown if the message could not be logged.
logger.info(string message, object... params)
Logs a message at INFO level.
- Parameters
-
- message
-
string
The message format to log. Params replace
{}in your message. - params
-
object
Arguments to include in the message.
- Returns
-
A
nullvalue if successful. - Throws
-
An exception is thrown if the message could not be logged.
logger.trace(string message, object... params)
Logs a message at TRACE level.
- Parameters
-
- message
-
string
The message format to log. Params replace
{}in your message. - params
-
object
Arguments to include in the message.
- Returns
-
A
nullvalue if successful. - Throws
-
An exception is thrown if the message could not be logged.
logger.warn(string message, object... params)
Logs a message at WARN level.
- Parameters
-
- message
-
string
The message format to log. Params replace
{}in your message. - params
-
object
Arguments to include in the message.
- Returns
-
A
nullvalue if successful. - Throws
-
An exception is thrown if the message could not be logged.