Artifactory 3.4
Skip to end of metadata
Go to start of metadata
Table of Contents

Overview

Artifactory uses the Logback Framework to manage logging. Activity is logged according to type in four different log files which can be found under the ARTIFACTORY_HOME/logs folder.

The following log files are available: 

artifactory.log

The main Artifactory log file containing data on Artifactory server activity

access.log

Security log containing important information about accepted and denied requests, configuration changes and password reset requests. The originating IP address for each event is also recorded

request.log

Generic http traffic information similar to the Apache HTTPd request log.

import.export.log

A log used for tracking the process of long-running import and export commands

Page Contents

Tomcat/Servlet container-specific log files

When running Artifactory inside an existing servlet container, the container typically has its own log files.

These files normally contain additional information to that in artifactory.log or application bootstrapping-time information that is not found in the Artifactory logs.

In Tomcat, these files are catalina.out and localhost.yyyy-mm-dd.log respectively.


Configuring Log Verbosity

The verbosity of any logger in your system can be configured by entering or modifying the level value in the corresponding entry in the Logback configuration file ARTIFACTORY_HOME/etc/logback.xml.

For example:

 

Modifying the verbosity of a logger

Artifactory loads any changes made to the Logback configuration file within several seconds without requiring a restart.

 


Log File Structure

The Request and Access log files each display specific type of activity and as such have a consistent and specific file structure for maximum readability

Request Log

A request log file record has the following structure:

Date and Time stamp  |  Request time  |  Request type  |  IP  |  User name  |  Request method  |  Requested resource path  |  Protocol version  |  Response code

Here is a typical example:

Request log file record sample

Date and time stamp

The date and time the request was completed and entered into the log file. Format is [YYYYMMDDHHMMSS]

Request time

The time in ms taken for the request to be processed

Request type

DOWNLOAD for a download request

UPLOAD for an upload request

REQUEST for any other request

IP

The requesting user's IP address

User name

The requesting user's user name or "non_authenticated_user" when accessed anonymously

Request method

The HTTP request method. e.g. GET, PUT etc.

Requested resource path

Relative path to the requested resource

Protocol version

The HTTP protocol version

Response code

The HTTP response code

Size (bytes) of request or response

If request method is GET: Size of response

If request method is PUT or POST: Size of request

Access Log

An access log file record has the following structure:

Date and Time stamp  |  Action response and type  |  Repository path (Optional)  |  Message (Optional)  |  User name  |  IP 

Here is a typical example:

Access log file record

Date and Time stamp 

The date and time that the entry was logged. Format is [YYYY-MM-DD HH:MM:SS, milliseconds]

[Action response and type]

The response (ACCEPTED/DENIED) and the action type (e.g. DOWNLOAD, UPLOAD etc.)

Repository path (Optional)

The repository that was accessed

Message (Optional)

An optional system message

User name

The accessing user's user name or "anonymous" when accessed anonymously

IP

The accessing user's IP address

Viewing Log Files from the UI

You can view or download any of the Artifactory log files from the UI.

From the Admin tab select Advanced | System Logs and select the file you want to view from the drop-list. The log tail view is automatically refreshed every few seconds.

Viewing Log Files

 

To save system resources, do not leave the log view open in your browser unnecessarily.

  • No labels