What's new

Released at: 30.08.2024

1. Use SSH Agent instead of $ORBIT_KEY for authentication.

2. New groups setting to specify virtual logfiles.

   // $ORBIT_HOME/config/lfv.json
   
   {
      "groups": {
         "Kafka": {
            "planets": "type=server%location:apac|p27",
            "files": [
               "data/logs/kafka/server*"
            ]
         }
      }
   }

3. New --workers flag to adjust the max count of parallel threads.

4. New filters setting to specify server-side content filters.

   // $ORBIT_HOME/config/lfv.json
   
   {
      "filters": [
         ["log/tcp_trace.*", 0, true, "KEY1", "KEY2"], // positive case
         ["log/th_*[^1-9]*", 0, false, "KEY1", "KEY2"] // negative case
      ]
   }

5. New cache-controls setting to customize header value.

6. New /configs endpoint to request client settings.

7. Fix timestamps setting was ignored.

8. Compiled binary for OSX build with MacOSX11.3 SDK.

9. Added binary for arm64-apple-darwin19 target.

10. Renamed config/lvf.json to config/iss.json.

11. Removed --size flag.

12. Upgraded to mruby 3.1.0

Full Changelog

What's new

Released at: 18.03.2020

1. Singularized folder names.

2. Hot reload of lfv.json when received SIGUSR1.

3. Fixed potential memory leaks.

4. Compiled binary for OSX build with MacOSX10.15 SDK.

5. Upgraded to mruby 2.1.0

Full Changelog

Released at: 13.08.2019

1. Added support for ECDSA for both key exchange and host key algorithms.

2. Updated /logs endpoint to return list in sorted order.

3. Updated /jobs endpoint to include run count and most recent timestamp.

4. Changed /reports endpoint to return timestamps as integers.

5. Fixed /logs/{path} endpoint failed to load files with null lines.

6. Fixed crash during shutdown when received SIGTERM or similar.

7. Fixed memory leak when converting LATIN-9 encoded files.

8. Renamed --host flag to --bind.

9. Compiled binary for OSX build with MacOSX10.13 SDK (Darwin17).

10. Upgraded to mruby 2.0.1

Full Changelog

Whats new

1. Dropped compatibility with orbit v1.4.6 due to breaking changes in fifa.

2. Removed LVAR section for non test builds.

3. Upgraded to mruby 2.0.0

Whats new

1. Compatibility with ski v1.4.6
2. Support for deflated transfer encoding.
3. Convert files with LATIN-9 charset encoding to UTF-8.

   // $ORBIT_HOME/config/lfv.json
   
   {
      "encodings": {
        "km/cfg/tcp_config": "latin"
      }
   }

4. Handle every request within its own process.
5. Cache several API endpoint results on client side that wont change frequently.
6. New --cleanup flag to adjust the interval to cleanup forked processes.
7. Ensure that fifa does not include ansi colors in its output.
8. Increase MacOSX min SDK version from 10.5 to to 10.11.
9. Remove 32-bit build targets.

Whats new

Tool

1. Great performance improvements by factor 15.
2. API routes have been redesign without having an /api prefix.

   $ iss --routes
   GET /embed/lfv/{planet}
   GET /jobs
   GET /jobs/{job_id}/reports
   GET /jobs/{job_id}/reports/{id}/results
   GET /planets
   GET /planets/{id}
   GET /planets/{id}/logs
   GET /planets/{id}/logs/{path}
   GET /stats
   GET /stats/{type}/count
   GET /stats/{type}/list
   HEAD /ping
   

3. New HEAD /ping route for better monitoring and GET /embed to embed the app.
4. The config settings for the log file viewer has been redesign and extended to the timestamps.

   // $ORBIT_HOME/config/lfv.json
   
   {
     "planets": "type=server%location:apac|p27",
     "files": ["km/log/tcp_trace.*","legato/log/th_*[^1-9][^2-9]","km/cfg/tcp_config"],
   
     "timestamps": [
       ["km/log/tcp_trace.*", 0, "Node",       0, 21, "d.m.y H:i:s.u"],
       ["legato/log/th_*",    0, "KM receive", 0, 26, "d.m.Y H:i:s.u"]
     ]
   }

   • planets is a single string that will be used to invoke fifa.
   • files is an array of path names who follow the syntax of fnmatch(3).
   • timestamps specifies which files contains timestamps and where to find them in each line.
5. New --timeout flag to adjust the read timeout of a socket.
6. New --size flag to adjust the size of the connection pool.
7. Server continues to run when SIGPIPE or SISSYS signal has been received.
8. Log date, time and signal on graceful shut-down.
9. Fixed various memory leaks.
10. Reduced memory footprint.

Web

1. Advanced live-search capabilities for the log file viewer
 (search, highlight, navigate and count).
2. Adjustable refresh intervals and download sizes for log files.
3. Filter log file entries by date range.
4. Drop-downs display additional infos like file size, last modified timestamp and the plc identifier for tcp traces
5. Page loads about 3 times faster.
6. Update notifier pops-up when an update has been detected.
7. The log file viewer loads 10 kB from the end of each file by default.

Whats new

A web frontend and API endpoint for Orbit.

$ usage: iss [options...]
Options:
-e, --environment The environment to run the server with
-h, --host        The host to bind the local server on
                  Defaults to: 0.0.0.0
-p, --port        The port number to start the local server on
                  Defaults to: 1974
-r, --routes      Print out all defined routes
-h, --help        This help text
-v, --version     Show version number

All endpoints have the /api/ prefix and usually return a JSON encoded result set.

$ iss --routes
GET /api/stats
GET /api/stats/{type}/count
GET /api/stats/{type}/list
GET /api/jobs
GET /api/jobs/{job_id}/reports
GET /api/jobs/{job_id}/reports/{id}/results
GET /api/lfv/planets
GET /api/lfv/planets/{id}/files
GET /api/lfv/planets/{id}/file

For example to get the total number of planets with type of web:

$ curl localhost:1974/api/stats/web/count

The tool expects to find the index.html file and related ressources under $ORBIT_HOME/public/iss. The file $ORBIT_HOME/public/iss/index.html maps to localhost:1974/iss/index.html.