Outbound Connection Logs

An OutboundConnectionLog is an audit log for monitoring and troubleshooting actions performed by your Remote Servers and Files.com on-premise Agents.

Logs available through this endpoint are retained for 6 months, after which they are automatically discarded. For longer retention, use Files.com SIEM integrations to stream logs in real time to your preferred SIEM, or configure SIEM streaming to a file.

List Outbound Connection Logs

SDK Method

outboundconnectionlog.List()

Return Object

[]*OutboundConnectionLog

Authorization Requirement

Requires either a Site-Wide API key or User API key or session from a User with Site Admin permissions.

Additional Arguments

Example Request

import (
    "fmt"
    "errors"

    files_sdk "github.com/Files-com/files-sdk-go/v3"
    outbound_connection_log "github.com/Files-com/files-sdk-go/v3/outboundconnectionlog"
)

outboundConnectionLogIterator, err := outbound_connection_log.List(files_sdk.OutboundConnectionLogListParams{})
if err != nil {
    var respErr files_sdk.ResponseError
    if errors.As(err, &respErr) {
        fmt.Println("Response Error Occurred (" + respErr.Type + "): " + respErr.ErrorMessage)
    } else {
        fmt.Printf("Unexpected Error: %s\n", err.Error())
    }
}

for outboundConnectionLogIterator.Next() {
    outboundConnectionLog := outboundConnectionLogIterator.outboundConnectionLog()
}
err = outboundConnectionLogIterator.Err()
if err != nil {
    var respErr files_sdk.ResponseError
    if errors.As(err, &respErr) {
        fmt.Println("Response Error Occurred (" + respErr.Type + "): " + respErr.ErrorMessage)
    } else {
        fmt.Printf("Unexpected Error: %s\n", err.Error())
    }
}

The OutboundConnectionLog Object

Some of the methods above return a OutboundConnectionLog object. The attributes of this object are listed below.

AttributeDescription
Timestamp
date-time		Start Time of Action. Deprecrated: Use created_at.
Path
string		Remote Path. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
ClientIp
string		End User IP
SrcRemoteServerId
int64		Source Remote Server ID
SrcRemoteServerName
string		Source Remote Server name
DestRemoteServerId
int64		Destination Remote Server ID
DestRemoteServerName
string		Destination Remote Server name
Operation
string		Operation Type
Possible values: copy_file, delete, download_request, home_path, list, list_recursive, list_recursive_with_download, list_with_download, metadata, mkdir, move_file, ping, rmdir_r, upload, upload_finalize, upload_request
ErrorMessage
string		Error message, if applicable
ErrorOperation
string		Error operation, if applicable
ErrorType
string		Error type, if applicable
Status
string		Status
Possible values: complete, error
DurationMs
int64		Duration (in milliseconds)
BytesUploaded
int64		Data Length in Bytes. Present for upload actions that transfer data.
BytesDownloaded
int64		Data Length in Bytes. Present for download actions that transfer data.
ListCount
int64		Number of entries returned for a folder list action.
CreatedAt
date-time		Start Time of Action