The API endpoint for Orbit.
Released at: 30.08.2024
-
Use SSH Agent instead of
$ORBIT_KEYfor authentication. -
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*" ] } } }
-
New
--workersflag to adjust the max count of parallel threads. -
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 ] }
-
New cache-controls setting to customize header value.
-
New
/configsendpoint to request client settings. -
Fix timestamps setting was ignored.
-
Compiled binary for OSX build with MacOSX11.3 SDK.
-
Added binary for
arm64-apple-darwin19target. -
Renamed
config/lvf.jsontoconfig/iss.json. -
Removed
--sizeflag. -
Upgraded to mruby 3.1.0
Released at: 18.03.2020
Releasenotes
-
Singularized folder names.
-
Hot reload of lfv.json when received
SIGUSR1. -
Fixed potential memory leaks.
-
Compiled binary for OSX build with MacOS 10.15 SDK.
-
Upgraded to mruby 2.1.0
Released at: 13.08.2019
Releasenotes
-
Added support for
ECDSAfor both key exchange and host key algorithms. -
Updated
/logsendpoint to return list in sorted order. -
Updated
/jobsendpoint to include run count and most recent timestamp. -
Changed
/reportsendpoint to return timestamps as integers. -
Fixed
/logs/{path}endpoint failed to load files with null lines. -
Fixed crash during shutdown when received SIGTERM or similar.
-
Fixed memory leak when converting LATIN-9 encoded files.
-
Renamed
--hostflag to--bind. -
Compiled binary for OSX build with MacOSX10.13 SDK (Darwin17).
-
Upgraded to mruby 2.0.1
Released at: 02.01.2019
Releasenotes
-
Dropped compatibility with orbit v1.4.6 due to breaking changes in fifa.
-
Removed LVAR section for non test builds.
-
Upgraded to mruby 2.0.0
Released at: 16.08.2018
Releasenotes
-
Compatibility with ski v1.4.6
-
Support for deflated transfer encoding.
-
Convert files with LATIN-9 charset encoding to UTF-8.
// $ORBIT_HOME/config/lfv.json { "encodings": { "km/cfg/tcp_config": "latin" } }
-
Handle every request within its own process.
-
Cache several API endpoint results on client side that wont change frequently.
-
New
--cleanupflag to adjust the interval to cleanup forked processes. -
Ensure that fifa does not include ansi colors in its output.
-
Increase MacOSX min SDK version from 10.5 to to 10.11.
-
Remove 32-bit build targets.
Released at: 26.06.2018
Releasenotes
-
Great performance improvements by factor 15.
-
API routes have been redesign without having an
/apiprefix.$ 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 -
New
HEAD /pingroute for better monitoring andGET /embedto embed the app. -
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"] ] }
planetsis a single string that will be used to invoke fifa.filesis an array of path names who follow the syntax of fnmatch(3).timestampsspecifies which files contains timestamps and where to find them in each line.
-
New
--timeoutflag to adjust the read timeout of a socket. -
New
--sizeflag to adjust the size of the connection pool. -
Server continues to run when SIGPIPE or SISSYS signal has been received.
-
Log date, time and signal on graceful shut-down.
-
Fixed various memory leaks.
-
Reduced memory footprint.
Released at: 12.02.2018
Releasenotes
Initial release
$ 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.