Tetra File-Log Agent Events

The Tetra File-Log Agent generates the following event types.

📘

NOTE

To set up event subscriptions for any of the following events, see Event Subscriptions.

Tetra File-Log Agent Event Types

agents.filelog.scanStarted.v1

A scan of a given path starts. This particular scan operation has a unique identifier associated with it, which is included in the event as scanId.

Event-Specific Data Example for agents.filelog.scanStarted.v1 Events

{
  "scanId": "a3c3af8c-a28d-4bbb-8323-797c39a45b69",
  "path": "C:\tmp\test3\",
  "startDate": "2023-01-11T00:00:00",
  "interval": 30,
  "fileWatchMode": "File",
  "sourceType": "unknown",
  "patterns": [
    "*/.*"
  ],
  "labels": [
    {
      "name": "instrument",
      "value": "akta"
    },
    {
      "name": "instrument_id",
      "value": "123"
    }
  ],
  "metadata": {
    "metadata1": "value1",
    "metadata2": "value2"
  },
  "tags": [
    "tag1",
    "tag2"
  ]
}

agents.filelog.scanCompleted.v1

A scan operation (identified by scanId) has completed. fileCount indicates the number of files found.

Event-Specific Data Example for agents.filelog.scanCompleted.v1 Events

📘

NOTE

The durationInSeconds property is available in Tetra File-Log Agent v4.4.0 and higher only.

{
  "scanId": "a3c3af8c-a28d-4bbb-8323-797c39a45b69",
  "path": "C:\tmp\test3\",
  "fileWatchMode": "File",
  "fileCount": 15,
  "duration": "00:00:00.0362367",
  "durationInSeconds": 0.0362367
}

agents.filelog.pathValidationFailed.v1

A file's path validation fails (is inaccessible) before scan operation starts.

Event-Specific Data Example for agents.filelog.pathValidationFailed.v1 Events

{
  "path": "C:\invalid\",
  "fileWatchMode": "File",
  "error": "Path 'C:\invalid\' does not exist or the Agent Group User does not have read permission\r\n"
}

agents.filelog.fileScanned.v1

A file has been scanned and identified for upload. This event is raised after the file has been persisted to the local SQLite database.

Event-Specific Data Example for agents.filelog.fileScanned.v1 Events

{
  "filePath": "/R90W9HZ4/c/tmp/test3/test5.txt",
  "osFilePath": "c:\tmp\test3\test5.txt",
  "osFolderPath": null,
  "fileId": "31a2c6f0-c181-43aa-a9a3-cdf168cdb522",
  "traceId": "31a2c6f0-c181-43aa-a9a3-cdf168cdb522",
  "changeDetectedBy": "Event",
  "scanId": "",
  "changeDescription": "New file detected.",
  "lastModifiedDate": "2023-02-16T16:25:17.8938926+00:00",
  "createDate": "2022-08-15T14:19:48.9528332+00:00",
  "reprocessAsOfDate": "2023-02-16T01:07:16.3240697+00:00",
  "isNew": true
}

agents.filelog.scanError.v1

An error occurs during a scan. For example, an IO exception occurs when trying to access a directory in a path.

Event-Specific Data Example for agents.filelog.scanError.v1 Events

{
  "path": "c:\tmp\InvalidDirectory",
  "error": "An IO exception has occurred attempting to access directory.",
  "scanId": "a3c3af8c-a28d-4bbb-8323-797c39a45b69"
}

agents.filelog.fileUploadStarted.v1

A file upload begins.

Event-Specific Data Example for agents.filelog.fileUploadStarted.v1 Events

{
  "filePath": "/R90W9HZ4/c/tmp/test3/test5.txt",
  "osFilePath": "c:\tmp\test3\test5.txt",
  "osFolderPath": null,
  "fileId": "31a2c6f0-c181-43aa-a9a3-cdf168cdb522",
  "traceId": "31a2c6f0-c181-43aa-a9a3-cdf168cdb522",
  "fileSize": 10
}

agents.filelog.fileUploadCompleted.v1

A file upload has completed successfully.

Event-Specific Data Example for agents.filelog.fileUploadCompleted.v1 Events

{
  "filePath": "/R90W9HZ4/c/tmp/test3/test5.txt",
  "osFilePath": "c:\tmp\test3\test5.txt",
  "osFolderPath": null,
  "fileId": "31a2c6f0-c181-43aa-a9a3-cdf168cdb522",
  "traceId": "31a2c6f0-c181-43aa-a9a3-cdf168cdb522",
  "fileLastModifiedDate": "2023-02-16T16:25:17.8938926+00:00",
  "fileCreateDate": "2022-08-15T14:19:48.9528332+00:00",
  "fileScanDate": "2023-02-16T16:25:24.955+00:00",
  "reprocessAsOfDate": "2023-02-16T01:07:16.3240697+00:00",
  "copyFileStartTime": "2023-02-16T16:25:48.6362834+00:00",
  "copyFileCompleteTime": "2023-02-16T16:25:48.6362834+00:00",
  "uploadFileStartTime": "2023-02-16T16:25:48.6525983+00:00",
  "fileSize": 10,
  "checksumAlgorithm": "MD5",
  "checksum": "0B01LUbONRqDtMWXNMY9mQ=="
}

agents.filelog.fileUploadFailed.v1

An error occurs before or during the upload of a file.

Event-Specific Data Example for agents.filelog.fileUploadFailed.v1 Events

{
  "filePath": "/R90W9HZ4/c/tmp/test3/test.txt",
  "osFilePath": "c:\tmp\test3\test.txt",
  "osFolderPath": null,
  "fileId": "4165a50a-5efd-4e05-9453-9fb2cc959b1d",
  "traceId": "4165a50a-5efd-4e05-9453-9fb2cc959b1d",
  "fileSize": 10,
  "error": "upload failed reason"
}

agents.filelog.fileArchiveStarted.v1

File archiving begins for a file.

Event-Specific Data Example for agents.filelog.fileArchiveStarted.v1 Events

{
  "filePath": "/R90W9HZ4/c/tmp/test3/test5.txt",
  "osFilePath": "c:\tmp\test3\test5.txt",
  "fileId": "31a2c6f0-c181-43aa-a9a3-cdf168cdb522",
  "traceId": "31a2c6f0-c181-43aa-a9a3-cdf168cdb522",
  "fileSize": 10,
  "archivePath": "c:\archive\55953bf0-acb6-4a45-beb6-cb30b33d4941\c\tmp\test3\test5.txt",
  "checksumAlgorithm": "MD5",
  "checksum": "0B01LUbONRqDtMWXNMY9mQ=="
}

agents.filelog.fileArchiveCompleted.v1

A file is successfully archived.

Event-Specific Data Example for agents.filelog.fileArchiveCompleted.v1 Events

{
  "filePath": "/R90W9HZ4/c/tmp/test3/test5.txt",
  "osFilePath": "c:\tmp\test3\test5.txt",
  "fileId": "31a2c6f0-c181-43aa-a9a3-cdf168cdb522",
  "traceId": "31a2c6f0-c181-43aa-a9a3-cdf168cdb522",
  "fileSize": 10,
  "archivePath": "c:\archive\55953bf0-acb6-4a45-beb6-cb30b33d4941\c\tmp\test3\test5.txt",
  "deleteAfter": "2023-02-16T16:32:03.9793437+00:00",
  "checksumAlgorithm": "MD5",
  "checksum": "0B01LUbONRqDtMWXNMY9mQ=="
}

agents.filelog.fileArchiveFailed.v1

An error occurs during file archival.

Event-Specific Data Example for agents.filelog.fileArchiveFailed.v1 Events

{
  "filePath": "/R90W9HZ4/c/tmp/test3/test4.txt",
  "osFilePath": "c:\tmp\test3\test4.txt",
  "fileId": "aa79b19f-6c99-49cf-bdff-68c8f927b6b6",
  "traceId": "aa79b19f-6c99-49cf-bdff-68c8f927b6b6",
  "error": "Source file has been removed but could not locate the archive file 'c:\archive\55953bf0-acb6-4a45-beb6-cb30b33d4941\c\tmp\test3\test4.txt'."
}

agents.filelog.fileArchiveSkipped.v1

File archiving for a file is skipped because of a missing checksum for the source file. This occurs when the file was originally uploaded by a previous version of the File-Log Agent, which didn't calculate and store the checksum at upload time.

Event-Specific Data Example for agents.filelog.fileArchiveSkipped.v1 Events

{
  "filePath": "/R90W9HZ4/c/tmp/test3/test4.txt",
  "osFilePath": "c:\tmp\test3\test4.txt",
  "fileId": "aa79b19f-6c99-49cf-bdff-68c8f927b6b6",
  "traceId": "aa79b19f-6c99-49cf-bdff-68c8f927b6b6",
  "reason": "Uploaded file does not have a checksum calculated."
}

agents.filelog.archiveFileDeleteCompleted.v1

A file is successfully deleted from the archive location.

Event-Specific Data Example for agents.filelog.archiveFileDeleteCompleted.v1 Events

{
  "filePath": "/R90W9HZ4/c/tmp/test3/test5.txt",
  "osFilePath": "c:\tmp\test3\test5.txt",
  "archiveFilePath": "c:\archive\55953bf0-acb6-4a45-beb6-cb30b33d4941\c\tmp\test3\test5.txt",
  "fileId": "31a2c6f0-c181-43aa-a9a3-cdf168cdb522",
  "traceId": "31a2c6f0-c181-43aa-a9a3-cdf168cdb522",
  "fileSize": 10
}

agents.filelog.archiveFileDeleteFailed.v1

An error occurs during archive file deletion.

Event-Specific Data Example for agents.filelog.archiveFileDeleteFailed.v1 Events

{
  "filePath": "/R90W9HZ4/c/tmp/test3/test5.txt",
  "osFilePath": "c:\tmp\test3\test5.txt",
  "archiveFilePath": "c:\archive\55953bf0-acb6-4a45-beb6-cb30b33d4941\c\tmp\test3\test5.txt",
  "fileId": "31a2c6f0-c181-43aa-a9a3-cdf168cdb522",
  "traceId": "31a2c6f0-c181-43aa-a9a3-cdf168cdb522",
  "error": "failure reason"
}