# Package org.apache.sis.util.logging

package org.apache.sis.util.logging
Extensions to the JDK logging framework. This package provides:

- A `Logging` utility class with static utility methods.
- A `PerformanceLevel` with configurable levels for logging the duration of lengthly processes.
- A `MonolineFormatter` for formatting the log records on single line with colors, for easier reading on the console output.

## Choosing a logging framework

The SIS project uses the standard `Logger` API for its logging. It does not mean that users of the SIS library are forced to use that logging framework. Java logging can be used as an API more powerful than `System​.Logger` and other frameworks can redirect Java logging to themselves. For example, adding the `jul-to-slf4j​.jar` dependency to a project is sufficient for redirecting Java logging to SLF4J.

Since:
  0.3
See Also:
  - Java Logging Overview

- Related Packages
  Module
  Package
  Description
  org.apache.sis.util
  org.apache.sis.util
  Simple data objects and miscellaneous utilities.
  org.apache.sis.util
  org.apache.sis.util.collection
  Addition to the collection framework.
  org.apache.sis.metadata
  org.apache.sis.util.iso
  Implementations of GeoAPI types from the `org​.opengis​.util` package.
- Classes
  Class
  Description
  Initializer
  Loads a logging configuration file using Java logging syntax augmented with Apache SIS extensions.
  Logging
  A set of utilities method for configuring loggings in SIS.
  MonolineFormatter
  A formatter writing log messages on a single line.
  PerformanceLevel
  Logging levels for data processing with execution time measurements.