---
# Contents
[TOC]
---
# Introduction
Object instance: `logger`
---
## Description
Manages logging messages in Lua via the [org.apache.log4j.Logger][log4j.Logger] class.
---
# Methods
---
## logger:debug
logger:debug (message)
- Logs a message at debug level.
- Parameters:
- message: _([string][LuaString])_ Text in logged message.
---
## logger:deprecated
logger:deprecated (old)
logger:deprecated (old, alt)
- Logs a deprecation warning.
- Parameters:
- old: _([string][LuaString])_ The deprecated item.
- alt: _([string][LuaString])_ Alternative to use.
---
## logger:error
logger:error (message)
logger:error (message, throwable)
logger:error (throwable)
- Logs a message at error level & optionally raises an exception.
- Parameters:
- message: _([string][LuaString])_ Text in logged message.
- throwable: _([Throwable][java.lang.Throwable])_ Exception to raise.
---
## logger:info
logger:info (message)
- Logs a message at info level.
- Parameters:
- message: _([string][LuaString])_ Text in logged message.
---
## logger:warn
logger:warn (message)
- Logs a message at warning level.
- Parameters:
- message: _([string][LuaString])_ Text in logged message.
---
# Usage Examples
```lua
local zone_name = "0_semos_city"
if game:setZone(zone_name) then
-- do something
else
logger:error("could not set zone: " .. zone_name)
end
```
[LuaString]: http://luaj.org/luaj/3.0/api/org/luaj/vm2/LuaString.html
[java.lang.Throwable]: https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Throwable.html
[log4j.Logger]: https://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Logger.html