v2.0.0

❗ Attentition "ULS COMMAND LINE USERS" ❗

The module list in the requirements.txt has increased. Make sure to install & update the required modules before running ULS 2.0.0 !

❗ Attentition "ULS DOCKER USERS" ❗

The baseimage for the ULS has changed from python:3.12-debian-slim to python:3.13-alpine
We are not expecting any issues - the container has been tested successfully.
In case you want to continue with the "debian" base image - we are still offering the same version in the following tag: akamai/uls:debian-lastest or akamai/uls:debian-v2.0.0

• Features

  • New output type: None - This improves debugging and analysing "processing" data
  • Complete rework of the "Callhome" functionality (non-blocking integration)
  • New "Callhome" feature to send stats stats delivery
  • Now also showing average CPU & Memory Usage (in %) within the 5 minute monitoring report (only recorded at event handling time - not a time average)
  • HTTP GZIP & BROTLI compression implemented (disabled by default) to reduce network overhead (Thx @ Bill !!)

• Major changes

  • We have moved the DOCKER core image from DEBIAN to ALPINE (to increase security and reduce the footprint)

• Minor improvements

  • Show "module version information" in ULS version output (only when --loglevel is set to DEBUG)
  • Removed ACL from Dockerfile
  • Added '.dockerignore' to decrease the docker footprint and increase the container security
  • Enhanced "Version" output to show "CPU type", number of cores and the available memory
  • Upgraded some of the pypi requirements (requests, prometheus_client, pytz, setuptools)
  • '--help' now shows the ENV-VAR names inline. No need to open a browser anymore when configuring ULS.
  • [docker-debian] bumped Python container version to 3.13
  • [docker-debian] bumped Python container version from debian12 (bookworm) to debian13 (trixie)
  • [docker] bumped CLI-EAA to branch 0.6.12 (new fields added, bugfixes)
  • [docker] bumped CLI-LINODE to version v0.0.8 (more detailed utilization support, bugfixes)

• Bugfixes

  • Fixed a bug that prevented the INPUTCLI from "failing properly", if anything happened during the input handling
  • Fixed a bug in the INPUTCLI, that could have caused a stale behavior of ULS in rare circumstances. We're exiting now properly.
  • Fixed a bug in the Inputhandling CLI AttributeError: module 'uls_config.global_config' has no attribute 'edgerc_openap'

v1.9.0

• Features

  • New --clidebug trigger to allow inline debugging of the underlying CLI (only works with RAW output)
  • Complete rework of the "INPUT CLI" tool to fix a bug related to start- and stoptime

• Bugfixes

  • fixed a bug that prevented json output on "EAA" --start & --end time
  • fixed a bug that resulted with a "Variable substition triggered but no value given (inline code issue)" error when using RAWCMD option for EAA
  • [docker] bumped CLI-LN to version 0.0.6 - (fixed a missing inline requirement)

v1.8.6

• ❗❗❗ SIA (former ETP) Users
  Please make sure to checkout a new alternative to ULS (which pulling the DNS logs from the API).
  The Akamai Secure Internet Access now allows a to PUSH the logs to you.

• Docfixes

  • Added requirements and a little more detailed instructions on the helm usage
  • Added an information related to an improved SIA (ETP) Log delivery alternative
    • ULS will show a 3 second warning, when input=sia feed=dns to let the user know that there is alternative
    • Added a FAQ section to introduce the new SIA capabilities

• Minor improvements

  • [docker] bumped Python container version to 3.13.3
  • [docker] bumped CLI-EAA to version 0.6.11 (removed RC tag)
  • [docker] bumped CLI-LN to version 0.0.5
  • [docker] bumped CLI-GC to version 0.0.7
  • [docker] bumped CLI-ETP to version 0.4.9 - now allowing 10x bigger page sizes !!
  • upgraded several "requirement" dependencies

v1.8.5

• Features

  • New ULS feed for Linode: UTILIZATION

    {"time": "2025-02-06T15:23:54.048512+00:00", "account": "Akamai Technologies - DEMO", "linode": 17, "lke_cluster": 5, "vpc": 9, "vlan": 21, "cloud_firewall": 41, "node_balancer": 15, "object_storage": 46, "volume": 127}

    This feed helps to understand and track the Linode account usage

• Minor improvements

  • [docker] bumped Python container version to 3.13.2

• Bugfixes

  • fixed a bug caused by newer ETP/SIA CLI when using the autoresume function (This is prone to fail again as we were tackling an API issue)
  • manually merged changes from PR#78 - issue #81 - something went wrong when merging the original PR - sorry for the inconvenience @vasantbala
  • Fixed a bug where the successful sending of HTTP was not properly logged - issue #82 - thanks again @vasantbala

Version History

v1.8.4

• Minor improvements

  • [docker] bumped Python container version to 3.12.8
  • [docker] bumped EAA container version to RC0.6.11

• Bugfixes

  • Bugfix for JSON Log Escaping (massive thx to @sethumadhav07 for the provided PR)

v1.8.3

• Minor improvements

  • [docker] bumped CLI-GC version to 0.0.6

• Bugfixes

  • Improved JSON Log Escaping (massive thx to @sethumadhav07 for the provided PR)

v1.8.2

• Features

  • Enabled Windows Support (natively run in python 3.12+ on Windows)

• Minor improvements

  • [docker] bumped CLI-ETP version to 0.4.8 (future api support fix)

• Bugfixes

  • Fixed a bug that caused an incompatibility with python versions < 3.12

• Housekeeping

  • improved python version testing (sampling py3.9 to 3.12)

v1.8.1

• Bugfixes
  • Merged a missing fix from the development branch

PLEASE USE ULS v1.8.1 instead

v1.8.9 lacks some merges - please use the latest version (or v1.8.1) instead of v1.8.0

v1.8.0

• Features

  • Prometheus monitoring support added to allow smoother monitoring into third party (prometheus compatible) monitoring sytems. More information here
  • CallHome (opt-out) function to enable the ULS team to collect anonymous statistics & usage information - more information here
  • Added the option to toggle Log Output towards "JSON" format (see feature request)
  • Added an option to manipulate the ULS internal logging format (see feature request and the Additional Features section)
  • Added an option to manipulate the ULS internal logging date/time format (see feature request

• Minor improvements

  • Updated all required packages to the latest version(s)
  • [docker] Bumped Python version to 3.12.5

• Bugfixes

  • issue when using jmespath transformation the result was not proper json - big thanks to @bart-parka for coming up with a PR to fix this

v1.7.5

• Minor improvements
  • Updated Command Line usage docs (ACC logs installation)
  • [docker] bumped GC-LOGS to version "0.0.5"
  • [docker] bumped CLI-EAA to version "0.6.10" - fixed the bug that crashed the EAA logs in ULS-Docker Container v1.7.4
  • [docker] changed the privilege within the docker (installation as root - then dropping to unprivileged user) - fix for Openshift + adding higher security
  • changed the path for the .edgerc mock to uls/var (instead of uls/ext)