mirror of
https://github.com/drakkan/sftpgo.git
synced 2025-12-07 14:50:55 +03:00
4e41a5583d
The common package defines the interfaces that a protocol must implement and contain code that can be shared among supported protocols. This way should be easier to support new protocols
55 lines
2.7 KiB
Markdown
55 lines
2.7 KiB
Markdown
# Logs
|
|
|
|
The log file is a stream of JSON structs. Each struct has a `sender` field that identifies the log type.
|
|
|
|
The logs can be divided into the following categories:
|
|
|
|
- **"app logs"**, internal logs used to debug SFTPGo:
|
|
- `sender` string. This is generally the package name that emits the log
|
|
- `time` string. Date/time with millisecond precision
|
|
- `level` string
|
|
- `message` string
|
|
- **"transfer logs"**, SFTP/SCP transfer logs:
|
|
- `sender` string. `Upload` or `Download`
|
|
- `time` string. Date/time with millisecond precision
|
|
- `level` string
|
|
- `elapsed_ms`, int64. Elapsed time, as milliseconds, for the upload/download
|
|
- `size_bytes`, int64. Size, as bytes, of the download/upload
|
|
- `username`, string
|
|
- `file_path` string
|
|
- `connection_id` string. Unique connection identifier
|
|
- `protocol` string. `SFTP` or `SCP`
|
|
- **"command logs"**, SFTP/SCP command logs:
|
|
- `sender` string. `Rename`, `Rmdir`, `Mkdir`, `Symlink`, `Remove`, `Chmod`, `Chown`, `Chtimes`, `SSHCommand`
|
|
- `level` string
|
|
- `username`, string
|
|
- `file_path` string
|
|
- `target_path` string
|
|
- `filemode` string. Valid for sender `Chmod` otherwise empty
|
|
- `uid` integer. Valid for sender `Chown` otherwise -1
|
|
- `gid` integer. Valid for sender `Chown` otherwise -1
|
|
- `access_time` datetime as YYYY-MM-DDTHH:MM:SS. Valid for sender `Chtimes` otherwise empty
|
|
- `modification_time` datetime as YYYY-MM-DDTHH:MM:SS. Valid for sender `Chtimes` otherwise empty
|
|
- `ssh_command`, string. Valid for sender `SSHCommand` otherwise empty
|
|
- `connection_id` string. Unique connection identifier
|
|
- `protocol` string. `SFTP`, `SCP` or `SSH`
|
|
- **"http logs"**, REST API logs:
|
|
- `sender` string. `httpd`
|
|
- `level` string
|
|
- `remote_addr` string. IP and port of the remote client
|
|
- `proto` string, for example `HTTP/1.1`
|
|
- `method` string. HTTP method (`GET`, `POST`, `PUT`, `DELETE` etc.)
|
|
- `user_agent` string
|
|
- `uri` string. Full uri
|
|
- `resp_status` integer. HTTP response status code
|
|
- `resp_size` integer. Size in bytes of the HTTP response
|
|
- `elapsed_ms` int64. Elapsed time, as milliseconds, to complete the request
|
|
- `request_id` string. Unique request identifier
|
|
- **"connection failed logs"**, logs for failed attempts to initialize a connection. A connection can fail for an authentication error or other errors such as a client abort or a timeout if the login does not happen in two minutes
|
|
- `sender` string. `connection_failed`
|
|
- `level` string
|
|
- `username`, string. Can be empty if the connection is closed before an authentication attempt
|
|
- `client_ip` string.
|
|
- `login_type` string. Can be `publickey`, `password`, `keyboard-interactive`, `publickey+password`, `publickey+keyboard-interactive` or `no_auth_tryed`
|
|
- `error` string. Optional error description
|