Download Latest Version tetra-darwin-amd64.tar.gz (15.2 MB)
Email in envelope

Get an email when there's a new version of Tetragon

Home / v1.3.0
Name Modified Size InfoDownloads / Week
Parent folder
tetra-darwin-amd64.tar.gz 2024-12-13 10.5 MB
tetra-darwin-amd64.tar.gz.sha256sum 2024-12-13 92 Bytes
tetra-darwin-arm64.tar.gz 2024-12-13 9.7 MB
tetra-darwin-arm64.tar.gz.sha256sum 2024-12-13 92 Bytes
tetra-linux-amd64.tar.gz 2024-12-13 16.3 MB
tetra-linux-amd64.tar.gz.sha256sum 2024-12-13 91 Bytes
tetra-linux-arm64.tar.gz 2024-12-13 14.7 MB
tetra-linux-arm64.tar.gz.sha256sum 2024-12-13 91 Bytes
tetra-windows-amd64.tar.gz 2024-12-13 10.2 MB
tetra-windows-amd64.tar.gz.sha256sum 2024-12-13 93 Bytes
tetra-windows-arm64.tar.gz 2024-12-13 9.1 MB
tetra-windows-arm64.tar.gz.sha256sum 2024-12-13 93 Bytes
tetragon-v1.3.0-amd64.tar.gz 2024-12-13 54.3 MB
tetragon-v1.3.0-amd64.tar.gz.sha256sum 2024-12-13 95 Bytes
tetragon-v1.3.0-arm64.tar.gz 2024-12-13 50.5 MB
tetragon-v1.3.0-arm64.tar.gz.sha256sum 2024-12-13 95 Bytes
README.md 2024-12-13 17.2 kB
Release v1.3.0 source code.tar.gz 2024-12-13 33.3 MB
Release v1.3.0 source code.zip 2024-12-13 45.6 MB
Totals: 19 Items   254.1 MB 0

Please update the description with the actual release notes and publish the release. See the release issue for instructions.

If this release was created from a test tag, please delete it.

v1.3.0

total: 364 commits, prs: 130 pr commits: 364

Upgrade notes

Read the upgrade notes carefully before upgrading Tetragon. Depending on your setup, changes listed here might require a manual intervention.

  • Behavior of export-file-perm flag (and corresponding Helm value tetragon.exportFilePerm) changed. In case the export file exists, but has different permissions than specified in the option, Tetragon will change the file permissions on the next log rotation. In older versions, log rotation preserved permissions of the existing file. Before upgrading check if permissions of the existing export file match the option (600 by default), and set the agent flag or Helm value to the desired value if needed.

Events (protobuf API)

New events for syscall64 type

Previous versions of Tetragon did not distinguish between different ABIs when using the syscall64 type because the output was just a size_arg with the id. When executing the getcpu syscall, for example, the JSON for 64- and 32-bits would be:

"args":[{"size_arg":"309"}]
"args":[{"size_arg":"318"}]

Note that id 318 for x86_64 is a different syscall: getrandom so we cannot distinguish between a getrandom syscall on x86_64 and a getcpu call on 32-bit (i386). To address this issue, the output of syscall64 was changed to a SyscallId object that also includes the ABI. So the JSON for 64- and 32-bits getcpu now is:

"args":[{"syscall_id":{"id":309,"abi":"x64"}}]
"args":[{"syscall_id":{"id":318,"abi":"i386"}}]

Users that want to maintain the old behavior can use the --enable-compatibility-syscall64-size-type flag for this version. The flag will be removed in v1.4.

Metrics

  • tetragon_ratelimit_dropped_total metric is renamed to tetragon_export_ratelimit_events_dropped_total

Major Changes:

Bugfixes:

Minor Changes:

CI Changes:

Documentation changes:

Dependency updates:

Misc Changes:

Source: README.md, updated 2024-12-13