# Log

Logs information to the specified log file

## Component Signature

```
<bx:Log text=[string]
file=[string]
log=[string]
type=[string]
application=[boolean] />
```

### Attributes

| Atrribute     | Type      | Required | Description                                                                                                                                                                                                                                                                        | Default |
| ------------- | --------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| `text`        | `string`  | `false`  | The text to log                                                                                                                                                                                                                                                                    |         |
| `file`        | `string`  | `false`  | (COMPAT ONLY) Do not use anymore, use log instead. If defined, we will use this instead of log.                                                                                                                                                                                    |         |
| `log`         | `string`  | `false`  | <p>The destination logger to use. If not passed, we use the default logger (application.log).<br>If the logger is a file appender and it doesn't exist it will create it for you.<br>If the value is an absolue path, it will create a file appender for you at that location.</p> |         |
| `type`        | `string`  | `false`  | The log level of the entry. One of "Information", "Warning", "Error", "Debug", "Trace"                                                                                                                                                                                             | `info`  |
| `application` | `boolean` | `false`  |                                                                                                                                                                                                                                                                                    | `true`  |

## Examples


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://boxlang.ortusbooks.com/boxlang-language/reference/components/system/log.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.