Skip to content

Commit 50d1093

Browse files
committed
Update readme
1 parent 9d6351d commit 50d1093

File tree

1 file changed

+174
-38
lines changed

1 file changed

+174
-38
lines changed

README.md

Lines changed: 174 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -71,64 +71,74 @@ seqcli <command> [<args>]
7171
Available commands:
7272

7373
- `apikey`
74-
- [`apikey create`](#apikey-create) &mdash; Create an API key for automation or ingestion.
75-
- [`apikey list`](#apikey-list) &mdash; List available API keys.
76-
- [`apikey remove`](#apikey-remove) &mdash; Remove an API key from the server.
74+
- [`apikey create`](#apikey-create) &mdash; Create an API key for automation or ingestion.
75+
- [`apikey list`](#apikey-list) &mdash; List available API keys.
76+
- [`apikey remove`](#apikey-remove) &mdash; Remove an API key from the server.
7777
- `app`
78-
- [`app define`](#app-define) &mdash; Generate an app definition for a .NET `[SeqApp]` plug-in.
79-
- [`app install`](#app-install) &mdash; Install an app package.
80-
- [`app run`](#app-run) &mdash; Host a .NET `[SeqApp]` plug-in.
81-
- [`app update`](#app-update) &mdash; Update an installed app package.
78+
- [`app define`](#app-define) &mdash; Generate an app definition for a .NET `[SeqApp]` plug-in.
79+
- [`app install`](#app-install) &mdash; Install an app package.
80+
- [`app list`](#app-list) &mdash; List installed app packages.
81+
- [`app run`](#app-run) &mdash; Host a .NET `[SeqApp]` plug-in.
82+
- [`app update`](#app-update) &mdash; Update an installed app package.
83+
- `appinstance`
84+
- [`appinstance create`](#appinstance-create) &mdash; Create an instance of an installed app.
85+
- [`appinstance list`](#appinstance-list) &mdash; List instances of installed apps.
86+
- [`appinstance remove`](#appinstance-remove) &mdash; Remove an app instance from the server.
8287
- [`bench`](#bench) &mdash; Measure query performance.
8388
- [`config`](#config) &mdash; View and set fields in the `SeqCli.json` file; run with no arguments to list all fields.
8489
- `dashboard`
85-
- [`dashboard list`](#dashboard-list) &mdash; List dashboards.
86-
- [`dashboard remove`](#dashboard-remove) &mdash; Remove a dashboard from the server.
87-
- [`dashboard render`](#dashboard-render) &mdash; Produce a CSV or JSON result set from a dashboard chart.
90+
- [`dashboard list`](#dashboard-list) &mdash; List dashboards.
91+
- [`dashboard remove`](#dashboard-remove) &mdash; Remove a dashboard from the server.
92+
- [`dashboard render`](#dashboard-render) &mdash; Produce a CSV or JSON result set from a dashboard chart.
8893
- `feed`
89-
- [`feed create`](#feed-create) &mdash; Create a NuGet feed.
90-
- [`feed list`](#feed-list) &mdash; List NuGet feeds.
91-
- [`feed remove`](#feed-remove) &mdash; Remove a NuGet feed from the server.
94+
- [`feed create`](#feed-create) &mdash; Create a NuGet feed.
95+
- [`feed list`](#feed-list) &mdash; List NuGet feeds.
96+
- [`feed remove`](#feed-remove) &mdash; Remove a NuGet feed from the server.
9297
- [`help`](#help) &mdash; Show information about available commands.
9398
- [`ingest`](#ingest) &mdash; Send log events from a file or `STDIN`.
9499
- [`license apply`](#license-apply) &mdash; Apply a license to the Seq server.
95100
- [`log`](#log) &mdash; Send a structured log event to the server.
96101
- `node`
97-
- [`node demote`](#node-demote) &mdash; Begin demotion of the current leader node.
98-
- [`node health`](#node-health) &mdash; Probe a Seq node's `/health` endpoint, and print the returned HTTP status code, or 'Unreachable' if the endpoint could not be queried.
99-
- [`node list`](#node-list) &mdash; List nodes in the Seq cluster.
102+
- [`node demote`](#node-demote) &mdash; Begin demotion of the current leader node.
103+
- [`node health`](#node-health) &mdash; Probe a Seq node's `/health` endpoint, and print the returned HTTP status code, or 'Unreachable' if the endpoint could not be queried.
104+
- [`node list`](#node-list) &mdash; List nodes in the Seq cluster.
100105
- [`print`](#print) &mdash; Pretty-print events in CLEF/JSON format, from a file or `STDIN`.
101106
- `profile`
102-
- [`profile create`](#profile-create) &mdash; Create or replace a connection profile.
103-
- [`profile list`](#profile-list) &mdash; List connection profiles.
104-
- [`profile remove`](#profile-remove) &mdash; Remove a connection profile.
107+
- [`profile create`](#profile-create) &mdash; Create or replace a connection profile.
108+
- [`profile list`](#profile-list) &mdash; List connection profiles.
109+
- [`profile remove`](#profile-remove) &mdash; Remove a connection profile.
105110
- [`query`](#query) &mdash; Execute an SQL query and receive results in CSV format.
106111
- `retention`
107-
- [`retention create`](#retention-create) &mdash; Create a retention policy.
108-
- [`retention list`](#retention-list) &mdash; List retention policies.
109-
- [`retention remove`](#retention-remove) &mdash; Remove a retention policy from the server.
112+
- [`retention create`](#retention-create) &mdash; Create a retention policy.
113+
- [`retention list`](#retention-list) &mdash; List retention policies.
114+
- [`retention remove`](#retention-remove) &mdash; Remove a retention policy from the server.
110115
- `sample`
111-
- [`sample ingest`](#sample-ingest) &mdash; Log sample events into a Seq instance.
112-
- [`sample setup`](#sample-setup) &mdash; Configure a Seq instance with sample dashboards, signals, users, and so on.
116+
- [`sample ingest`](#sample-ingest) &mdash; Log sample events into a Seq instance.
117+
- [`sample setup`](#sample-setup) &mdash; Configure a Seq instance with sample dashboards, signals, users, and so on.
113118
- [`search`](#search) &mdash; Retrieve log events that match a given filter.
119+
- `setting`
120+
- [`setting clear`](#setting-clear) &mdash; Clear a runtime-configurable server setting.
121+
- [`setting names`](#setting-names) &mdash; Print the names of all supported settings.
122+
- [`setting set`](#setting-set) &mdash; Change a runtime-configurable server setting.
123+
- [`setting show`](#setting-show) &mdash; Print the current value of a runtime-configurable server setting.
114124
- `signal`
115-
- [`signal create`](#signal-create) &mdash; Create a signal.
116-
- [`signal import`](#signal-import) &mdash; Import signals in newline-delimited JSON format.
117-
- [`signal list`](#signal-list) &mdash; List available signals.
118-
- [`signal remove`](#signal-remove) &mdash; Remove a signal from the server.
125+
- [`signal create`](#signal-create) &mdash; Create a signal.
126+
- [`signal import`](#signal-import) &mdash; Import signals in newline-delimited JSON format.
127+
- [`signal list`](#signal-list) &mdash; List available signals.
128+
- [`signal remove`](#signal-remove) &mdash; Remove a signal from the server.
119129
- [`tail`](#tail) &mdash; Stream log events matching a filter.
120130
- `template`
121-
- [`template export`](#template-export) &mdash; Export entities into template files.
122-
- [`template import`](#template-import) &mdash; Import entities from template files.
131+
- [`template export`](#template-export) &mdash; Export entities into template files.
132+
- [`template import`](#template-import) &mdash; Import entities from template files.
123133
- `user`
124-
- [`user create`](#user-create) &mdash; Create a user.
125-
- [`user list`](#user-list) &mdash; List users.
126-
- [`user remove`](#user-remove) &mdash; Remove a user from the server.
134+
- [`user create`](#user-create) &mdash; Create a user.
135+
- [`user list`](#user-list) &mdash; List users.
136+
- [`user remove`](#user-remove) &mdash; Remove a user from the server.
127137
- [`version`](#version) &mdash; Print the current executable version.
128138
- `workspace`
129-
- [`workspace create`](#workspace-create) &mdash; Create a workspace.
130-
- [`workspace list`](#workspace-list) &mdash; List available workspaces.
131-
- [`workspace remove`](#workspace-remove) &mdash; Remove a workspace from the server.
139+
- [`workspace create`](#workspace-create) &mdash; Create a workspace.
140+
- [`workspace list`](#workspace-list) &mdash; List available workspaces.
141+
- [`workspace remove`](#workspace-remove) &mdash; Remove a workspace from the server.
132142

133143
### `apikey create`
134144

@@ -236,6 +246,27 @@ seqcli app install --package-id 'Seq.App.JsonArchive'
236246
| `--no-color` | Don't colorize text output |
237247
| `--force-color` | Force redirected output to have ANSI color (unless `--no-color` is also specified) |
238248

249+
### `app list`
250+
251+
List installed app packages.
252+
253+
Example:
254+
255+
```
256+
seqcli app list
257+
```
258+
259+
| Option | Description |
260+
| ------ | ----------- |
261+
| `--package-id=VALUE` | The package id of the app(s) to list |
262+
| `-i`, `--id=VALUE` | The id of a single app to list |
263+
| `--json` | Print output in newline-delimited JSON (the default is plain text) |
264+
| `--no-color` | Don't colorize text output |
265+
| `--force-color` | Force redirected output to have ANSI color (unless `--no-color` is also specified) |
266+
| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` config value will be used |
267+
| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default the `connection.apiKey` config value will be used |
268+
| `--profile=VALUE` | A connection profile to use; by default the `connection.serverUrl` and `connection.apiKey` config values will be used |
269+
239270
### `app run`
240271

241272
Host a .NET `[SeqApp]` plug-in.
@@ -282,13 +313,76 @@ seqcli app update -n 'HTML Email'
282313
| `--no-color` | Don't colorize text output |
283314
| `--force-color` | Force redirected output to have ANSI color (unless `--no-color` is also specified) |
284315

316+
### `appinstance create`
317+
318+
Create an instance of an installed app.
319+
320+
Example:
321+
322+
```
323+
seqcli appinstance create -t 'Email Ops' --app hostedapp-314159 -p [email protected]
324+
```
325+
326+
| Option | Description |
327+
| ------ | ----------- |
328+
| `-t`, `--title=VALUE` | A title for the app instance |
329+
| `--app=VALUE` | The id of the installed app package to instantiate |
330+
| `-p`, `--property=NAME=VALUE` | Specify name/value settings for the app, e.g. `-p [email protected] -p Subject="Alert!"` |
331+
| `--stream[=VALUE]` | Stream incoming events to this app instance as they're ingested; optionally accepts a signal expression limiting which events should be streamed |
332+
| `--overridable=VALUE` | Specify setting names that may be overridden by users when invoking the app |
333+
| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` config value will be used |
334+
| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default the `connection.apiKey` config value will be used |
335+
| `--profile=VALUE` | A connection profile to use; by default the `connection.serverUrl` and `connection.apiKey` config values will be used |
336+
| `--json` | Print output in newline-delimited JSON (the default is plain text) |
337+
| `--no-color` | Don't colorize text output |
338+
| `--force-color` | Force redirected output to have ANSI color (unless `--no-color` is also specified) |
339+
340+
### `appinstance list`
341+
342+
List instances of installed apps.
343+
344+
Example:
345+
346+
```
347+
seqcli appinstance list
348+
```
349+
350+
| Option | Description |
351+
| ------ | ----------- |
352+
| `-t`, `--title=VALUE` | The title of the app instance(s) to list |
353+
| `-i`, `--id=VALUE` | The id of a single app instance to list |
354+
| `--json` | Print output in newline-delimited JSON (the default is plain text) |
355+
| `--no-color` | Don't colorize text output |
356+
| `--force-color` | Force redirected output to have ANSI color (unless `--no-color` is also specified) |
357+
| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` config value will be used |
358+
| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default the `connection.apiKey` config value will be used |
359+
| `--profile=VALUE` | A connection profile to use; by default the `connection.serverUrl` and `connection.apiKey` config values will be used |
360+
361+
### `appinstance remove`
362+
363+
Remove an app instance from the server.
364+
365+
Example:
366+
367+
```
368+
seqcli appinstance remove -t 'Email Ops'
369+
```
370+
371+
| Option | Description |
372+
| ------ | ----------- |
373+
| `-t`, `--title=VALUE` | The title of the app instance(s) to remove |
374+
| `-i`, `--id=VALUE` | The id of a single app instance to remove |
375+
| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` config value will be used |
376+
| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default the `connection.apiKey` config value will be used |
377+
| `--profile=VALUE` | A connection profile to use; by default the `connection.serverUrl` and `connection.apiKey` config values will be used |
378+
285379
### `bench`
286380

287381
Measure query performance.
288382

289383
| Option | Description |
290384
| ------ | ----------- |
291-
| `-r`, `--runs=VALUE` | The number of runs to execute |
385+
| `-r`, `--runs=VALUE` | The number of runs to execute; the default is 10 |
292386
| `-c`, `--cases=VALUE` | A JSON file containing the set of cases to run. Defaults to a standard set of cases. |
293387
| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` config value will be used |
294388
| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default the `connection.apiKey` config value will be used |
@@ -297,6 +391,9 @@ Measure query performance.
297391
| `--end=VALUE` | ISO 8601 date/time to query to |
298392
| `--reporting-server=VALUE` | The address of a Seq server to send bench results to |
299393
| `--reporting-apikey=VALUE` | The API key to use when connecting to the reporting server |
394+
| `--description=VALUE` | Optional description of the bench test run |
395+
| `--with-ingestion` | Should the benchmark include sending events to Seq |
396+
| `--with-queries` | Should the benchmark include querying Seq |
300397

301398
### `config`
302399

@@ -670,6 +767,7 @@ seqcli retention create --after 30d --delete-all-events
670767
| ------ | ----------- |
671768
| `--after=VALUE` | A duration after which the policy will delete events, e.g. `7d` |
672769
| `--delete-all-events` | The policy should delete all events (currently the only supported option) |
770+
| `--delete=VALUE` | Stream incoming events to this app instance as they're ingested; optionally accepts a signal expression limiting which events should be streamed |
673771
| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` config value will be used |
674772
| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default the `connection.apiKey` config value will be used |
675773
| `--profile=VALUE` | A connection profile to use; by default the `connection.serverUrl` and `connection.apiKey` config values will be used |
@@ -775,6 +873,45 @@ seqcli search -f "@Exception like '%TimeoutException%'" -c 30
775873
| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default the `connection.apiKey` config value will be used |
776874
| `--profile=VALUE` | A connection profile to use; by default the `connection.serverUrl` and `connection.apiKey` config values will be used |
777875

876+
### `setting clear`
877+
878+
Clear a runtime-configurable server setting.
879+
880+
| Option | Description |
881+
| ------ | ----------- |
882+
| `-n`, `--name=VALUE` | The setting name, for example `OpenIdConnectClientSecret` |
883+
| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` config value will be used |
884+
| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default the `connection.apiKey` config value will be used |
885+
| `--profile=VALUE` | A connection profile to use; by default the `connection.serverUrl` and `connection.apiKey` config values will be used |
886+
887+
### `setting names`
888+
889+
Print the names of all supported settings.
890+
891+
### `setting set`
892+
893+
Change a runtime-configurable server setting.
894+
895+
| Option | Description |
896+
| ------ | ----------- |
897+
| `-n`, `--name=VALUE` | The setting name, for example `OpenIdConnectClientSecret` |
898+
| `-v`, `--value=VALUE` | The setting value, comma-separated if multiple values are accepted |
899+
| `--value-stdin` | Read the value from `STDIN` |
900+
| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` config value will be used |
901+
| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default the `connection.apiKey` config value will be used |
902+
| `--profile=VALUE` | A connection profile to use; by default the `connection.serverUrl` and `connection.apiKey` config values will be used |
903+
904+
### `setting show`
905+
906+
Print the current value of a runtime-configurable server setting.
907+
908+
| Option | Description |
909+
| ------ | ----------- |
910+
| `-n`, `--name=VALUE` | The setting name, for example `OpenIdConnectClientSecret` |
911+
| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` config value will be used |
912+
| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default the `connection.apiKey` config value will be used |
913+
| `--profile=VALUE` | A connection profile to use; by default the `connection.serverUrl` and `connection.apiKey` config values will be used |
914+
778915
### `signal create`
779916

780917
Create a signal.
@@ -1048,7 +1185,6 @@ seqcli workspace remove -t 'My Workspace'
10481185
| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default the `connection.apiKey` config value will be used |
10491186
| `--profile=VALUE` | A connection profile to use; by default the `connection.serverUrl` and `connection.apiKey` config values will be used |
10501187

1051-
10521188
## Extraction patterns
10531189

10541190
The `seqcli ingest` command can be used for parsing plain text logs into structured log events.

0 commit comments

Comments
 (0)