seqcli
La aplicación de línea de comandos del cliente Seq. Admite registro ( seqcli log
), búsqueda ( search
), seguimiento ( tail
), consulta ( query
) e ingesta de archivos de registro JSON o de texto sin formato ( ingest
), y mucho más.
El instalador de Seq para Windows incluye seqcli
. De lo contrario, descargue la versión para su sistema operativo. O, si tiene instalado dotnet
, seqcli
se puede instalar como una herramienta global usando:
dotnet tool install --global seqcli
Para configurar una URL de servidor predeterminada y una clave API, ejecute:
seqcli config -k connection.serverUrl -v https://your-seq-server
seqcli config -k connection.apiKey -v your-api-key
La clave API se almacenará en su archivo de configuración SeqCli.json
; en Windows, esto se cifra mediante DPAPI; En Mac/Linux, la clave está actualmente almacenada en texto sin formato. Como alternativa a almacenar la clave API en la configuración, se puede pasar a cada comando mediante el argumento --apikey=
.
seqcli
también está disponible como contenedor Docker en datalust/seqcli
:
docker run --rm datalust/seqcli:latest []
Para conectarse a Seq en un contenedor acoplable en la máquina local, use la dirección IP de la máquina (no localhost) o especifique la red del host acoplable con --net host
.
Utilice redes y volúmenes de Docker para que seqcli
pueda acceder a archivos locales y otros contenedores dentro de su contenedor.
Cada valor de configuración se puede anular en tiempo de ejecución especificando una variable de entorno del formato SEQCLI_
, donde contiene un elemento para cada segmento de puntos del nombre de la configuración, separados por guiones bajos.
Por ejemplo, la configuración connection.serverUrl
se puede anular con la variable SEQCLI_CONNECTION_SERVERURL
.
Si está automatizando la configuración de Seq, es probable que aún no tenga una clave API para que la use seqcli
. Durante la configuración inicial del servidor Seq, puede especificar firstRun.adminUsername
y firstRun.adminPasswordHash
(o las variables de entorno equivalentes SEQ_FIRSTRUN_ADMINUSERNAME
y SEQ_FIRSTRUN_ADMINPASSWORDHASH
) para establecer un nombre de usuario y una contraseña iniciales para la cuenta de administrador. Puede usarlos para crear una clave API y luego usar el token de clave API con los comandos seqcli
restantes.
El comando seqcli apikey create
acepta --connect-username
y --connect-password-stdin
e imprime el nuevo token de clave API en STDOUT
(la sintaxis de PowerShell se usa a continuación):
$user = "admin"
$pw = "thepassword"
$token = (
echo $pw |
seqcli apikey create `
-t CLI `
--permissions="Read,Write,Project,Organization,System" `
--connect-username $user --connect-password-stdin
)
Consulte CONTRIBUTING.md
.
Al conectarse con una clave API, las operaciones permitidas están determinadas por los permisos asignados a esa clave API.
Para determinar el permiso requerido para un comando, consulte la columna "Solicitud de permiso" de la operación API del servidor equivalente. Por ejemplo, el comando apikey create
utiliza el punto final POST api/apikeys
, que requiere permiso Write
.
Todos los comandos seqcli
siguen el mismo patrón:
seqcli []
La lista completa de comandos admitidos se puede ver ejecutando:
seqcli help
Para mostrar información de uso para un comando específico, ejecute seqcli help
, por ejemplo:
seqcli help apikey create
Esto también funciona para grupos de mando; para enumerar todos los subcomandos apikey
, ejecute:
seqcli help apikey
apikey
apikey create
: crea una clave API para automatización o ingesta.apikey list
: enumera las claves API disponibles.apikey remove
: elimina una clave API del servidor.apikey update
: actualiza una clave API existente.app
app define
: genera una definición de aplicación para un complemento .NET [SeqApp]
.app install
: instala un paquete de aplicación.app list
: enumera los paquetes de aplicaciones instalados.app run
: aloja un complemento .NET [SeqApp]
.app uninstall
: desinstala un paquete de aplicación.app update
: actualiza un paquete de aplicación instalado.appinstance
appinstance create
: crea una instancia de una aplicación instalada.appinstance list
: enumera instancias de aplicaciones instaladas.appinstance remove
: elimina una instancia de aplicación del servidor.appinstance update
: actualiza una instancia de aplicación existente.bench
: mide el rendimiento de las consultas.config
: ve y configura campos en el archivo SeqCli.json
; ejecute sin argumentos para enumerar todos los campos.dashboard
dashboard list
: lista de paneles.dashboard remove
: elimina un panel del servidor.dashboard render
: produzca un conjunto de resultados CSV o JSON a partir de un gráfico del panel.expressionindex
expressionindex create
: crea un índice de expresión.expressionindex list
: enumera los índices de expresiones.expressionindex remove
: elimina un índice de expresión del servidor.feed
feed create
: cree un feed NuGet.feed list
: muestra los feeds de NuGet.feed remove
: elimina un feed NuGet del servidor.feed update
: actualiza un feed NuGet existente.help
: muestra información sobre los comandos disponibles.index
index list
: lista de índices.index suppress
: suprime un índice.ingest
: envía eventos de registro desde un archivo o STDIN
.license apply
: aplica una licencia al servidor Seq.log
: envía un evento de registro estructurado al servidor.node
node demote
: comienza la degradación del nodo líder actual.node health
: sondee el punto final /health
de un nodo Seq e imprima el código de estado HTTP devuelto, o "Inalcanzable" si no se pudo consultar el punto final.node list
: enumera los nodos en el clúster Seq.print
: eventos de impresión bonita en formato CLEF/JSON, desde un archivo o STDIN
.profile
profile create
: crea o reemplaza un perfil de conexión.profile list
: enumera los perfiles de conexión.profile remove
: elimina un perfil de conexión.query
: ejecute una consulta SQL y reciba los resultados en formato CSV.retention
retention create
: cree una política de retención.retention list
: enumera las políticas de retención.retention remove
: elimina una política de retención del servidor.retention update
: actualiza una política de retención existente.sample
sample ingest
: registra eventos de muestra en una instancia de Seq.sample setup
: configure una instancia de Seq con paneles de ejemplo, señales, usuarios, etc.search
: recupera eventos de registro que coinciden con un filtro determinado.setting
setting clear
: borra una configuración del servidor configurable en tiempo de ejecución.setting names
: imprime los nombres de todas las configuraciones admitidas.setting set
: cambia una configuración del servidor configurable en tiempo de ejecución.setting show
: imprime el valor actual de una configuración de servidor configurable en tiempo de ejecución.signal
signal create
: crea una señal.signal import
: importe señales en formato JSON delimitado por nuevas líneas.signal list
: enumera las señales disponibles.signal remove
: elimina una señal del servidor.signal update
: actualiza una señal existente.tail
: eventos de registro de transmisión que coinciden con un filtro.template
template export
: exporta entidades a archivos de plantilla.template import
: importe entidades desde archivos de plantilla.user
user create
: crea un usuario.user list
: lista de usuarios.user remove
: elimina un usuario del servidor.user update
: actualiza un usuario existente.version
: imprime la versión ejecutable actual.workspace
workspace create
: crea un espacio de trabajo.workspace list
: muestra los espacios de trabajo disponibles.workspace remove
: elimina un espacio de trabajo del servidor.workspace update
: actualiza un espacio de trabajo existente.apikey create
Cree una clave API para automatización o ingesta.
Ejemplo:
seqcli apikey create -t 'Test API Key' -p Environment=Test
Opción | Descripción |
---|---|
-t , --title=VALUE | Un título para la clave API |
--token=VALUE | Un token de clave API preasignado; De forma predeterminada, se generará un nuevo token y se escribirá en STDOUT |
-p , --property=NAME=VALUE | Especifique las propiedades de nombre/valor, por ejemplo -p Customer=C123 -p Environment=Production |
--filter=VALUE | Un filtro para aplicar a los eventos entrantes. |
--minimum-level=VALUE | El nivel/gravedad mínimo del evento a aceptar; el valor predeterminado es aceptar todos los eventos |
--use-server-timestamps | Descartar las marcas de tiempo proporcionadas por el cliente y utilizar los valores del reloj del servidor |
--permissions=VALUE | Una lista de permisos separados por comas para delegar a la clave API; Los permisos válidos son Ingest (predeterminado), Read , Write , Project y System |
--connect-username=VALUE | Un nombre de usuario con el que conectarse, útil principalmente al configurar la primera clave API; Los servidores con suscripción 'Individual' solo permiten una solicitud simultánea con esta opción |
--connect-password=VALUE | Cuando se especifica connect-username , la contraseña correspondiente |
--connect-password-stdin | Cuando se especifica connect-username , lea la contraseña correspondiente de STDIN |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
--json | Imprima la salida en JSON delimitado por nuevas líneas (el valor predeterminado es texto sin formato) |
--no-color | No colorear la salida de texto |
--force-color | Forzar que la salida redirigida tenga color ANSI (a menos que también se especifique --no-color ) |
apikey list
Enumere las claves API disponibles.
Ejemplo:
seqcli apikey list
Opción | Descripción |
---|---|
-t , --title=VALUE | El título de las claves API que se enumerarán |
-i , --id=VALUE | La identificación de una única clave API para enumerar |
--json | Imprima la salida en JSON delimitado por nuevas líneas (el valor predeterminado es texto sin formato) |
--no-color | No colorear la salida de texto |
--force-color | Forzar que la salida redirigida tenga color ANSI (a menos que también se especifique --no-color ) |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
apikey remove
Elimine una clave API del servidor.
Ejemplo:
seqcli apikey remove -t 'Test API Key'
Opción | Descripción |
---|---|
-t , --title=VALUE | El título de las claves API que se eliminarán |
-i , --id=VALUE | La identificación de una única clave API para eliminar |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
apikey update
Actualice una clave API existente.
Ejemplo:
seqcli apikey update --json '{...}'
Opción | Descripción |
---|---|
--json=VALUE | La clave API actualizada en formato JSON; esto se puede producir usando seqcli apikey list --json |
--json-stdin | Lea la clave API actualizada como JSON de STDIN |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
app define
Genere una definición de aplicación para un complemento .NET [SeqApp]
.
Ejemplo:
seqcli app define -d "./bin/Debug/netstandard2.2"
Opción | Descripción |
---|---|
-d , --directory=VALUE | El directorio que contiene los ensamblados de .NET Standard; por defecto es el directorio actual |
--type=VALUE | El nombre del tipo de complemento [SeqApp]; El valor predeterminado es escanear ensamblajes para un solo tipo marcado con este atributo. |
--indented | Formatee la definición en varias líneas con sangría |
app install
Instale un paquete de aplicación.
Ejemplo:
seqcli app install --package-id 'Seq.App.JsonArchive'
Opción | Descripción |
---|---|
--package-id=VALUE | La identificación del paquete de la aplicación a instalar. |
--version=VALUE | La versión del paquete a instalar; el valor predeterminado es instalar la última versión |
--feed-id=VALUE | La identificación del feed NuGet desde donde instalar el paquete; se puede omitir si solo se configura una fuente |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
--json | Imprima la salida en JSON delimitado por nuevas líneas (el valor predeterminado es texto sin formato) |
--no-color | No colorear la salida de texto |
--force-color | Forzar que la salida redirigida tenga color ANSI (a menos que también se especifique --no-color ) |
app list
Enumere los paquetes de aplicaciones instalados.
Ejemplo:
seqcli app list
Opción | Descripción |
---|---|
--package-id=VALUE | La identificación del paquete de las aplicaciones a enumerar. |
-i , --id=VALUE | La identificación de una sola aplicación para enumerar. |
--json | Imprima la salida en JSON delimitado por nuevas líneas (el valor predeterminado es texto sin formato) |
--no-color | No colorear la salida de texto |
--force-color | Forzar que la salida redirigida tenga color ANSI (a menos que también se especifique --no-color ) |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
app run
Aloje un complemento .NET [SeqApp]
.
Ejemplo:
seqcli tail --json | seqcli app run -d "./bin/Debug/netstandard2.2" -p [email protected]
Opción | Descripción |
---|---|
-d , --directory=VALUE | El directorio que contiene los ensamblados de .NET Standard; por defecto es el directorio actual |
--type=VALUE | El nombre del tipo de complemento [SeqApp]; El valor predeterminado es escanear ensamblajes para un solo tipo marcado con este atributo. |
-p , --property=NAME=VALUE | Especifique la configuración de nombre/valor para la aplicación, por ejemplo -p [email protected] -p Subject="Alert!" |
--storage=VALUE | Un directorio en el que se pueden almacenar datos específicos de la aplicación; por defecto es el directorio actual |
-s , --server=VALUE | La URL del servidor Seq, utilizada solo para la configuración de la aplicación (no se realiza ninguna conexión con el servidor); De forma predeterminada, se utilizará el valor de connection.serverUrl |
--server-instance=VALUE | El nombre de la instancia del servidor Seq, usado solo para la configuración de la aplicación; por defecto no tiene nombre de instancia |
-t , --title=VALUE | El título de la instancia de la aplicación, usado solo para la configuración de la aplicación; por defecto es un título de marcador de posición. |
--id=VALUE | La identificación de la instancia de la aplicación, que se usa solo para la configuración de la aplicación; El valor predeterminado es una identificación de marcador de posición. |
--read-env | Lea la configuración de la aplicación y los ajustes de las variables de entorno, como se especifica en https://docs.datalust.co/docs/seq-apps-in-other-languages; ignora todas las opciones excepto --directory y --type |
app uninstall
Desinstalar un paquete de aplicación.
Ejemplo:
seqcli app uninstall --package-id 'Seq.App.JsonArchive'
Opción | Descripción |
---|---|
--package-id=VALUE | La identificación del paquete de la aplicación que se va a desinstalar. |
-i , --id=VALUE | La identificación de un único paquete de aplicación para desinstalar. |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
app update
Actualice un paquete de aplicación instalado.
Ejemplo:
seqcli app update -n 'HTML Email'
Opción | Descripción |
---|---|
-i , --id=VALUE | La identificación de una única aplicación instalada para actualizar. |
-n , --name=VALUE | El nombre de la aplicación instalada para actualizar. |
--all | Actualice todas las aplicaciones instaladas; no compatible con -i o -n |
--version=VALUE | La versión del paquete a actualizar; el valor predeterminado es actualizar a la última versión en el feed asociado |
--force | Actualice la aplicación incluso si la versión de destino ya está instalada |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
--json | Imprima la salida en JSON delimitado por nuevas líneas (el valor predeterminado es texto sin formato) |
--no-color | No colorear la salida de texto |
--force-color | Forzar que la salida redirigida tenga color ANSI (a menos que también se especifique --no-color ) |
appinstance create
Cree una instancia de una aplicación instalada.
Ejemplo:
seqcli appinstance create -t 'Email Ops' --app hostedapp-314159 -p [email protected]
Opción | Descripción |
---|---|
-t , --title=VALUE | Un título para la instancia de la aplicación. |
--app=VALUE | La identificación del paquete de aplicación instalado para crear una instancia. |
-p , --property=NAME=VALUE | Especifique la configuración de nombre/valor para la aplicación, por ejemplo -p [email protected] -p Subject="Alert!" |
--stream[=VALUE] | Transmita eventos entrantes a esta instancia de aplicación a medida que se ingieran; opcionalmente acepta una expresión de señal que limita qué eventos deben transmitirse, por ejemplo signal-1,signal-2 |
--overridable=VALUE | Especifique nombres de configuración que los usuarios pueden anular al invocar la aplicación |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
--json | Imprima la salida en JSON delimitado por nuevas líneas (el valor predeterminado es texto sin formato) |
--no-color | No colorear la salida de texto |
--force-color | Forzar que la salida redirigida tenga color ANSI (a menos que también se especifique --no-color ) |
appinstance list
Enumere instancias de aplicaciones instaladas.
Ejemplo:
seqcli appinstance list
Opción | Descripción |
---|---|
-t , --title=VALUE | El título de las instancias de la aplicación que se enumerarán |
-i , --id=VALUE | La identificación de una única instancia de aplicación para enumerar |
--json | Imprima la salida en JSON delimitado por nuevas líneas (el valor predeterminado es texto sin formato) |
--no-color | No colorear la salida de texto |
--force-color | Forzar que la salida redirigida tenga color ANSI (a menos que también se especifique --no-color ) |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
appinstance remove
Elimine una instancia de aplicación del servidor.
Ejemplo:
seqcli appinstance remove -t 'Email Ops'
Opción | Descripción |
---|---|
-t , --title=VALUE | El título de las instancias de la aplicación que se eliminarán. |
-i , --id=VALUE | La identificación de una única instancia de aplicación para eliminar. |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
appinstance update
Actualice una instancia de aplicación existente.
Ejemplo:
seqcli appinstance update --json '{...}'
Opción | Descripción |
---|---|
--json=VALUE | La instancia de la aplicación actualizada en formato JSON; esto se puede producir usando seqcli appinstance list --json |
--json-stdin | Lea la instancia de la aplicación actualizada como JSON desde STDIN |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
bench
Mida el rendimiento de las consultas.
Opción | Descripción |
---|---|
-r , --runs=VALUE | El número de ejecuciones a ejecutar; el valor predeterminado es 10 |
-c , --cases=VALUE | Un archivo JSON que contiene el conjunto de casos a ejecutar. El valor predeterminado es un conjunto estándar de casos. |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
--start=VALUE | Fecha/hora ISO 8601 para realizar la consulta |
--end=VALUE | Fecha/hora ISO 8601 para realizar la consulta |
--reporting-server=VALUE | La dirección de un servidor Seq al que enviar resultados de banco. |
--reporting-apikey=VALUE | La clave API que se utilizará al conectarse al servidor de informes |
--description=VALUE | Descripción opcional de la ejecución de prueba en banco |
--with-ingestion | ¿Debería el punto de referencia incluir el envío de eventos a Seq? |
--with-queries | ¿Debería el punto de referencia incluir la consulta de Seq? |
config
Ver y configurar campos en el archivo SeqCli.json
; ejecute sin argumentos para enumerar todos los campos.
Opción | Descripción |
---|---|
-k , --key=VALUE | El campo, por ejemplo connection.serverUrl |
-v , --value=VALUE | El valor del campo; si no se especifica, el comando imprimirá el valor actual |
-c , --clear | Limpiar el campo |
dashboard list
Listar paneles.
Ejemplo:
seqcli dashboard list
Opción | Descripción |
---|---|
-t , --title=VALUE | El título de los paneles que se van a enumerar |
-i , --id=VALUE | La identificación de un único panel para enumerar |
-o , --owner=VALUE | La identificación del usuario para el cual enumerar los paneles; De forma predeterminada, se enumeran los paneles compartidos. |
--json | Imprima la salida en JSON delimitado por nuevas líneas (el valor predeterminado es texto sin formato) |
--no-color | No colorear la salida de texto |
--force-color | Forzar que la salida redirigida tenga color ANSI (a menos que también se especifique --no-color ) |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
dashboard remove
Eliminar un panel del servidor.
Ejemplo:
seqcli dashboard remove -i dashboard-159
Opción | Descripción |
---|---|
-t , --title=VALUE | El título de los paneles que se van a eliminar |
-i , --id=VALUE | La identificación de un único panel para eliminar |
-o , --owner=VALUE | La identificación del usuario para quien se eliminarán los paneles; De forma predeterminada, los paneles compartidos se eliminan. |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
dashboard render
Genere un conjunto de resultados CSV o JSON a partir de un gráfico del panel.
Ejemplo:
seqcli dashboard render -i dashboard-159 -c 'Response Time (ms)' --last 7d --by 1h
Opción | Descripción |
---|---|
-i , --id=VALUE | La identificación de un único panel para renderizar. |
-c , --chart=VALUE | El título de un gráfico en el tablero para representar. |
--last=VALUE | Una duración durante la cual se debe representar el gráfico, por ejemplo, 7d ; esto se alineará con un límite de intervalo; Se debe especificar --last o --start y --end |
--by=VALUE | El intervalo de tiempo para los datos del gráfico, como duración, por ejemplo, 1h |
--start=VALUE | Fecha/hora ISO 8601 para realizar la consulta |
--end=VALUE | Fecha/hora ISO 8601 para realizar la consulta |
--signal=VALUE | Una expresión de señal o una lista de identificadores de señales intersectadas para aplicar, por ejemplo signal-1,signal-2 |
--timeout=VALUE | El tiempo de espera de ejecución en milisegundos. |
--json | Imprima la salida en JSON delimitado por nuevas líneas (el valor predeterminado es texto sin formato) |
--no-color | No colorear la salida de texto |
--force-color | Forzar que la salida redirigida tenga color ANSI (a menos que también se especifique --no-color ) |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
expressionindex create
Cree un índice de expresión.
Ejemplo:
seqcli expressionindex create --expression "ServerName"
Opción | Descripción |
---|---|
-e , --expression=VALUE | La expresión a indexar |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
--json | Imprima la salida en JSON delimitado por nuevas líneas (el valor predeterminado es texto sin formato) |
--no-color | No colorear la salida de texto |
--force-color | Forzar que la salida redirigida tenga color ANSI (a menos que también se especifique --no-color ) |
expressionindex list
Listar índices de expresiones.
Ejemplo:
seqcli expressionindex list
Opción | Descripción |
---|---|
-i , --id=VALUE | La identificación de un índice de expresión única para enumerar. |
--json | Imprima la salida en JSON delimitado por nuevas líneas (el valor predeterminado es texto sin formato) |
--no-color | No colorear la salida de texto |
--force-color | Forzar que la salida redirigida tenga color ANSI (a menos que también se especifique --no-color ) |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
expressionindex remove
Eliminar un índice de expresión del servidor.
Ejemplo:
seqcli expressionindex -i expressionindex-2529
Opción | Descripción |
---|---|
-i , --id=VALUE | La identificación de un índice de expresión para eliminar. |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
feed create
Cree una fuente NuGet.
Ejemplo:
seqcli feed create -n 'CI' --location="https://f.feedz.io/example/ci" -u Seq --password-stdin
Opción | Descripción |
---|---|
-n , --name=VALUE | Un nombre único para el feed. |
-l , --location=VALUE | La ubicación del feed; Esta puede ser una URL de fuente NuGet v2 o v3, o una ruta del sistema de archivos local en el servidor Seq. |
-u , --username=VALUE | El nombre de usuario que Seq debe proporcionar al conectarse al feed, si se requiere autenticación |
-p , --password=VALUE | Una contraseña de feed, si se requiere autenticación; tenga en cuenta que --password-stdin es más seguro |
--password-stdin | Leer la contraseña del feed de STDIN |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
--json | Imprima la salida en JSON delimitado por nuevas líneas (el valor predeterminado es texto sin formato) |
--no-color | No colorear la salida de texto |
--force-color | Forzar que la salida redirigida tenga color ANSI (a menos que también se especifique --no-color ) |
feed list
Enumere los feeds de NuGet.
Ejemplo:
seqcli feed list
Opción | Descripción |
---|---|
-n , --name=VALUE | El nombre del feed a listar. |
-i , --id=VALUE | La identificación de un único feed para listar. |
--json | Imprima la salida en JSON delimitado por nuevas líneas (el valor predeterminado es texto sin formato) |
--no-color | No colorear la salida de texto |
--force-color | Forzar que la salida redirigida tenga color ANSI (a menos que también se especifique --no-color ) |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
feed remove
Elimine una fuente NuGet del servidor.
Ejemplo:
seqcli feed remove -n CI
Opción | Descripción |
---|---|
-n , --name=VALUE | El nombre del feed a eliminar. |
-i , --id=VALUE | La identificación de un único feed para eliminar. |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
feed update
Actualice una fuente NuGet existente.
Ejemplo:
seqcli feed update --json '{...}'
Opción | Descripción |
---|---|
--json=VALUE | El feed NuGet actualizado en formato JSON; esto se puede producir usando seqcli feed list --json |
--json-stdin | Lea el feed NuGet actualizado como JSON desde STDIN |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
help
Muestra información sobre los comandos disponibles.
Ejemplo:
seqcli help search
Opción | Descripción |
---|---|
-m , --markdown | Generar rebajas para usar en la documentación. |
index list
Listar índices.
Ejemplo:
seqcli index list
Opción | Descripción |
---|---|
-i , --id=VALUE | La identificación de un único índice para enumerar. |
--json | Imprima la salida en JSON delimitado por nuevas líneas (el valor predeterminado es texto sin formato) |
--no-color | No colorear la salida de texto |
--force-color | Forzar que la salida redirigida tenga color ANSI (a menos que también se especifique --no-color ) |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
index suppress
Suprimir un índice.
Ejemplo:
seqcli index suppress -i index-2191448f1d9b4f22bd32c6edef752748
Opción | Descripción |
---|---|
-i , --id=VALUE | La identificación de un índice para suprimir. |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
ingest
Envía eventos de registro desde un archivo o STDIN
.
Ejemplo:
seqcli ingest -i log-*.txt --json --filter="@Level <> 'Debug'" -p Environment=Test
Opción | Descripción |
---|---|
-i , --input=VALUE | Archivo(s) a ingerir, incluido el comodín * ; si no se especifica, se utilizará STDIN |
--invalid-data=VALUE | Especifique cómo se manejan los datos no válidos: fail (predeterminado) o ignore |
-p , --property=NAME=VALUE | Especifique las propiedades de nombre/valor, por ejemplo -p Customer=C123 -p Environment=Production |
-x , --extract=VALUE | Un patrón de extracción para aplicar a registros de texto sin formato (ignorado cuando se especifica --json ) |
--json | Leer los eventos como JSON (el valor predeterminado asume texto sin formato) |
-f , --filter=VALUE | Filtrar expresión para seleccionar un subconjunto de eventos |
-m , --message=VALUE | Un mensaje para asociar con los eventos ingeridos; Se admite la sintaxis de https://messagetemplates.org |
-l , --level=VALUE | El nivel o gravedad a asociar con los eventos ingeridos; esto anulará cualquier información de nivel presente en los eventos mismos |
--send-failure=VALUE | Especifique cómo se manejan los errores de conexión: fail (predeterminado), retry , continue o ignore |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
--batch-size=VALUE | El número máximo de eventos que se enviarán en cada solicitud al punto final de ingesta; si no se especifica se utilizará un valor de 100 |
license apply
Aplicar una licencia al servidor Seq.
Ejemplo:
seqcli license apply --certificate="license.txt"
Opción | Descripción |
---|---|
-c , --certificate=VALUE | Archivo de certificado; el archivo debe ser texto UTF-8 |
--certificate-stdin | Leer el certificado de licencia de STDIN |
--automatically-refresh | Si la licencia es para una suscripción, consulte periódicamente datalust.co y actualice automáticamente el certificado cuando se cambie o renueve la suscripción. |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
log
Envíe un evento de registro estructurado al servidor.
Ejemplo:
seqcli log -m 'Hello, {Name}!' -p Name=World -p App=Test
Opción | Descripción |
---|---|
-m , --message=VALUE | Un mensaje para asociar con el evento (el valor predeterminado es no enviar ningún mensaje); Se admite la sintaxis de https://messagetemplates.org |
-l , --level=VALUE | El nivel o gravedad del evento (el valor predeterminado es Information ) |
-t , --timestamp=VALUE | La marca de tiempo del evento es ISO-8601 (la marca de tiempo UTC actual se usará de forma predeterminada) |
-x , --exception=VALUE | Información adicional de excepción o error para enviar, si corresponde |
-p , --property=NAME=VALUE | Especifique las propiedades de nombre/valor, por ejemplo -p Customer=C123 -p Environment=Production |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
node demote
Comienza la degradación del nodo líder actual.
Ejemplo:
seqcli node demote --verbose --wait
Opción | Descripción |
---|---|
--wait | Espere a que el líder sea degradado antes de salir. |
-y , --confirm | Responda [sí] cuando se le solicite continuar |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
node health
Sondee el punto final /health
de un nodo Seq e imprima el código de estado HTTP devuelto, o "Inalcanzable" si no se pudo consultar el punto final.
Ejemplo:
seqcli node health -s https://seq-2.example.com
Opción | Descripción |
---|---|
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
node list
Enumere los nodos en el clúster Seq.
Ejemplo:
seqcli node list --json
Opción | Descripción |
---|---|
-n , --name=VALUE | El nombre del nodo del clúster que se va a enumerar. |
-i , --id=VALUE | La identificación de un único nodo del clúster para enumerar |
--json | Imprima la salida en JSON delimitado por nuevas líneas (el valor predeterminado es texto sin formato) |
--no-color | No colorear la salida de texto |
--force-color | Forzar que la salida redirigida tenga color ANSI (a menos que también se especifique --no-color ) |
-s , --server=VALUE | La URL del servidor Seq; De forma predeterminada, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor; De forma predeterminada, se utilizará el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión a utilizar; De forma predeterminada, se utilizarán los valores de configuración connection.serverUrl y connection.apiKey |
print
Imprima eventos en formato CLEF/JSON, desde un archivo o STDIN
.
Ejemplo:
seqcli print -i log-20201028.clef
Opción | Descripción |
---|---|
-i , --input=VALUE | Archivo CLEF para leer, incluido el comodín * ; si no se especifica, se utilizará STDIN |
-f , --filter=VALUE | Filtrar expresión para seleccionar un subconjunto de eventos |
--template=VALUE | Especificar una plantilla de salida para controlar el formato de texto sin formato |
--invalid-data=VALUE | Especifique cómo se manejan los datos no válidos: fail (predeterminado) o ignore |
--no-color | No colorear la salida de texto |
--force-color | Forzar que la salida redirigida tenga color ANSI (a menos que también se especifique --no-color ) |
profile create
Cree o reemplace un perfil de conexión.
Ejemplo:
seqcli profile create -n Production -s https://seq.example.com -a th15ISanAPIk3y
Opción | Descripción |
---|---|
-n , --name=VALUE | El nombre del perfil de conexión. |
-s , --server=VALUE | La URL del servidor Seq. |
-a , --apikey=VALUE | La clave API que se utilizará al conectarse al servidor, si es necesario |
profile list
Listar perfiles de conexión.
Ejemplo:
seqcli profile list
profile remove
Eliminar un perfil de conexión.
Ejemplo:
seqcli profile remove -n Production
Opción | Descripción |
---|---|
-n , --name=VALUE | El nombre del perfil de conexión a eliminar. |
query
Ejecute una consulta SQL y reciba los resultados en formato CSV.
Ejemplo:
seqcli query -q "select count(*) from stream group by @Level" --start="2018-02-28T13:00Z"
Opción | Descripción |
---|---|
-q , --query=VALUE | La consulta a ejecutar |
--start=VALUE | Fecha/hora ISO 8601 para realizar la consulta |
--end=VALUE | Fecha/hora ISO 8601 para realizar la consulta |
--signal=VALUE | Una expresión de señal o una lista de identificadores de señales intersectadas para aplicar, por ejemplo signal-1,signal-2 |
--timeout=VALUE | El tiempo de espera de ejecución en milisegundos. |
--json | Imprima la salida en JSON delimitado por nuevas líneas (el valor predeterminado es texto sin formato) |
--no-color | No colorear la salida de texto |
--force-color | Forzar que la salida redirigida tenga color ANSI (a menos que también se especifique --no-color ) |
-s , --server=VALUE | La URL del servidor Seq; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
retention create
Crear una política de retención.
Ejemplo:
seqcli retention create --after 30d --delete-all-events
Opción | Descripción |
---|---|
--after=VALUE | Una duración después de la cual la política eliminará los eventos, por ejemplo, 7d |
--delete-all-events | La política debe eliminar todos los eventos (actualmente la única opción compatible) |
--delete=VALUE | Transmitir eventos entrantes a esta instancia de la aplicación mientras están ingeridos; Opcionalmente acepta una expresión de señal que limita qué eventos deben transmitirse |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
--json | La salida de impresión en JSON de Newline-Delimited (el valor predeterminado es el texto sin formato) |
--no-color | No coloree la salida de texto |
--force-color | La salida redirigida de la fuerza tiene color ANSI (a menos que también se especifique --no-color ) |
retention list
Listas de políticas de retención.
Ejemplo:
seqcli retention list
Opción | Descripción |
---|---|
-i , --id=VALUE | La identificación de una sola política de retención a la lista |
--json | La salida de impresión en JSON de Newline-Delimited (el valor predeterminado es el texto sin formato) |
--no-color | No coloree la salida de texto |
--force-color | La salida redirigida de la fuerza tiene color ANSI (a menos que también se especifique --no-color ) |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
retention remove
Eliminar una política de retención del servidor.
Ejemplo:
seqcli retention remove -i retentionpolicy-17
Opción | Descripción |
---|---|
-i , --id=VALUE | La identificación de una sola política de retención para eliminar |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
retention update
Actualizar una política de retención existente.
Ejemplo:
seqcli retention update --json '{...}'
Opción | Descripción |
---|---|
--json=VALUE | La política de retención actualizada en formato JSON; Esto se puede producir utilizando seqcli retention list --json |
--json-stdin | Lea la política de retención actualizada como JSON de STDIN |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
sample ingest
Registre eventos de muestra en una instancia de SEQ.
Ejemplo:
seqcli sample ingest
Opción | Descripción |
---|---|
-y , --confirm | Respuesta [y] es cuando se le solicite que continúe |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
--quiet | No se haga eco de eventos ingeridos a STDOUT |
--batch-size=VALUE | El número máximo de eventos para enviar cada solicitud al punto final de ingestión; Si no se especifica, se utilizará un valor de 100 |
sample setup
Configure una instancia SEQ con paneles de muestra, señales, usuarios, etc.
Ejemplo:
seqcli sample setup
Opción | Descripción |
---|---|
-y , --confirm | Respuesta [y] es cuando se le solicite que continúe |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
search
Recupere eventos de registro que coincidan con un filtro dado.
Ejemplo:
seqcli search -f "@Exception like '%TimeoutException%'" -c 30
Opción | Descripción |
---|---|
-f , --filter=VALUE | Un filtro para aplicar a la búsqueda, por ejemplo, Host = 'xmpweb-01.example.com' |
-c , --count=VALUE | El número máximo de eventos para recuperar; El valor predeterminado es 1 |
--start=VALUE | ISO 8601 Fecha/hora para consultar desde |
--end=VALUE | ISO 8601 Fecha/hora para consultar a |
--json | La salida de impresión en JSON de Newline-Delimited (el valor predeterminado es el texto sin formato) |
--no-color | No coloree la salida de texto |
--force-color | La salida redirigida de la fuerza tiene color ANSI (a menos que también se especifique --no-color ) |
--signal=VALUE | Una expresión de señal o lista de ID de señal intersectados para aplicar, por ejemplo, signal-1,signal-2 |
--request-timeout=VALUE | El tiempo permitió recuperar cada página de eventos, en milisegundos; El valor predeterminado es 100000 |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
setting clear
Borrar una configuración de servidor configurable con tiempo de ejecución.
Opción | Descripción |
---|---|
-n , --name=VALUE | El nombre de configuración, por ejemplo, OpenIdConnectClientSecret |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
setting names
Imprima los nombres de todas las configuraciones compatibles.
setting set
Cambie una configuración de servidor configurable por tiempo de ejecución.
Opción | Descripción |
---|---|
-n , --name=VALUE | El nombre de configuración, por ejemplo, OpenIdConnectClientSecret |
-v , --value=VALUE | El valor de configuración, separado por comas. Si se aceptan múltiples valores |
--value-stdin | Lea el valor de STDIN |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
setting show
Imprima el valor actual de una configuración de servidor configurable por tiempo de ejecución.
Opción | Descripción |
---|---|
-n , --name=VALUE | El nombre de configuración, por ejemplo, OpenIdConnectClientSecret |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
signal create
Crear una señal.
Ejemplo:
seqcli signal create -t 'Exceptions' -f "@Exception is not null"
Opción | Descripción |
---|---|
-t , --title=VALUE | Un título para la señal |
--description=VALUE | Una descripción de la señal |
-f , --filter=VALUE | Filtrar para asociarse con la señal |
-c , --column=VALUE | Columna para asociar con la señal; Este argumento se puede usar varias veces |
--group=VALUE | Un nombre de grupo explícito para asociar con la señal; El valor predeterminado es inferir el grupo desde el filtro |
--no-group | Especificar que no se debe inferir ningún grupo; El valor predeterminado es inferir el grupo desde el filtro |
--protected | Especificar que la señal es editable solo por los administradores |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
--json | La salida de impresión en JSON de Newline-Delimited (el valor predeterminado es el texto sin formato) |
--no-color | No coloree la salida de texto |
--force-color | La salida redirigida de la fuerza tiene color ANSI (a menos que también se especifique --no-color ) |
signal import
Señales de importación en formato JSON de Newline Delimited.
Ejemplo:
seqcli signal import -i ./Exceptions.json
Opción | Descripción |
---|---|
--merge | Actualizar señales que tienen IDS que coinciden con las de los datos importados; El valor predeterminado es siempre crear nuevas señales |
-i , --input=VALUE | Archivo para importar; Si no se especifica, STDIN se utilizará |
-o , --owner=VALUE | La identificación del usuario para importar señales; Por defecto, las señales compartidas son importd |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
signal list
Lista de señales disponibles.
Ejemplo:
seqcli signal list
Opción | Descripción |
---|---|
-t , --title=VALUE | El título de la (s) señal (s) para enumerar |
-i , --id=VALUE | La identificación de una sola señal para enumerar |
-o , --owner=VALUE | La identificación del usuario para enumerar las señales; Por defecto, las señales compartidas son listd |
--json | La salida de impresión en JSON de Newline-Delimited (el valor predeterminado es el texto sin formato) |
--no-color | No coloree la salida de texto |
--force-color | La salida redirigida de la fuerza tiene color ANSI (a menos que también se especifique --no-color ) |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
signal remove
Elimine una señal del servidor.
Ejemplo:
seqcli signal remove -t 'Test Signal'
Opción | Descripción |
---|---|
-t , --title=VALUE | El título de la (s) señal (s) para eliminar |
-i , --id=VALUE | La identificación de una sola señal para eliminar |
-o , --owner=VALUE | La identificación del usuario para eliminar las señales para; Por defecto, las señales compartidas se eliminan |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
signal update
Actualizar una señal existente.
Ejemplo:
seqcli signal update --json '{...}'
Opción | Descripción |
---|---|
--json=VALUE | La señal actualizada en formato JSON; Esto se puede producir usando seqcli signal list --json |
--json-stdin | Lea la señal actualizada como JSON desde STDIN |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
tail
Eventos de registro de transmisión que coinciden con un filtro.
Opción | Descripción |
---|---|
-f , --filter=VALUE | Un filtro opcional del lado del servidor para aplicar a la transmisión, por ejemplo, @Level = 'Error' |
--json | La salida de impresión en JSON de Newline-Delimited (el valor predeterminado es el texto sin formato) |
--no-color | No coloree la salida de texto |
--force-color | La salida redirigida de la fuerza tiene color ANSI (a menos que también se especifique --no-color ) |
--signal=VALUE | Una expresión de señal o lista de ID de señal intersectados para aplicar, por ejemplo, signal-1,signal-2 |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
template export
Exportar entidades a archivos de plantilla.
Ejemplo:
seqcli template export -o ./Templates
Opción | Descripción |
---|---|
-o , --output=VALUE | El directorio en el que escribir archivos de plantilla; El directorio debe existir; Se sobrescribirán cualquier archivo existente con nombres que coincidan con las plantillas exportadas; El valor predeterminado es . |
-i , --include=VALUE | La identificación de una señal, tablero, consulta guardada, espacio de trabajo o política de retención para exportar; Este argumento puede especificarse varias veces; El valor predeterminado es exportar todas las entidades compartidas |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
template import
Importar entidades desde archivos de plantilla.
Ejemplo:
seqcli template import -i ./Templates
Opción | Descripción |
---|---|
-i , --input=VALUE | El directorio desde el cual leer el conjunto de archivos .template ; El valor predeterminado es . |
--state=VALUE | La ruta de un archivo que persistirá una asignación de nombres de plantilla a las ID de las entidades creadas en el servidor de destino, evitando duplicados cuando se realizan múltiples importaciones; Por defecto, se utilizará import.state en el directorio de entrada |
--merge | Para plantillas sin entradas en el archivo .state , primero verifique las entidades existentes con nombres o títulos coincidentes; no apoya la fusión de políticas de retención |
-g , --arg=NAME=VALUE | Argumentos de plantilla, por ejemplo -g ownerId=user-314159 |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
user create
Crear un usuario.
Ejemplo:
seqcli user create -n alice -d 'Alice Example' -r 'User (read/write)' --password-stdin
Opción | Descripción |
---|---|
-n , --name=VALUE | Un nombre de usuario único para el usuario |
-d , --display-name=VALUE | Un nombre de forma larga para ayudar a identificar al usuario |
-f , --filter=VALUE | Un filtro de vista que limita los eventos visibles para el usuario |
-r , --role=VALUE | El título de un rol que otorga permisos del usuario en el servidor; Si no se especifica, se asignará el rol de nuevo usuario predeterminado |
-e , --email=VALUE | La dirección de correo electrónico del usuario (habilita una imagen de gravatar para el usuario) |
-p , --password=VALUE | Una contraseña inicial para el usuario, si la autenticación de nombre de usuario/contraseña está en uso; Tenga en cuenta que --password-stdin es más seguro |
--password-stdin | Lea la contraseña inicial para el usuario desde STDIN , si la autenticación de nombre de usuario/contraseña está en uso |
--no-password-change | No obligue al usuario a cambiar su contraseña al siguiente inicio de sesión |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
--json | La salida de impresión en JSON de Newline-Delimited (el valor predeterminado es el texto sin formato) |
--no-color | No coloree la salida de texto |
--force-color | La salida redirigida de la fuerza tiene color ANSI (a menos que también se especifique --no-color ) |
user list
Lista de usuarios.
Ejemplo:
seqcli user list
Opción | Descripción |
---|---|
-n , --name=VALUE | El nombre de usuario de los usuarios para enumerar |
-i , --id=VALUE | La identificación de un solo usuario para enumerar |
--json | La salida de impresión en JSON de Newline-Delimited (el valor predeterminado es el texto sin formato) |
--no-color | No coloree la salida de texto |
--force-color | La salida redirigida de la fuerza tiene color ANSI (a menos que también se especifique --no-color ) |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
user remove
Eliminar un usuario del servidor.
Ejemplo:
seqcli user remove -n alice
Opción | Descripción |
---|---|
-n , --name=VALUE | El nombre de usuario de los usuarios para eliminar |
-i , --id=VALUE | La identificación de un solo usuario para eliminar |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
user update
Actualizar a un usuario existente.
Ejemplo:
seqcli user update --json '{...}'
Opción | Descripción |
---|---|
--json=VALUE | El usuario actualizado en formato JSON; Esto se puede producir utilizando seqcli user list --json |
--json-stdin | Lea el usuario actualizado como JSON desde STDIN |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
version
Imprima la versión ejecutable actual.
workspace create
Crea un espacio de trabajo.
Ejemplo:
seqcli workspace create -t 'My Workspace' -c signal-314159 -c dashboard-628318
Opción | Descripción |
---|---|
-t , --title=VALUE | Un título para el espacio de trabajo |
--description=VALUE | Una descripción del espacio de trabajo |
-c , --content=VALUE | La identificación de un tablero, señal o consulta guardada para incluir en el espacio de trabajo |
--protected | Especificar que el espacio de trabajo es editable solo por los administradores |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
--json | La salida de impresión en JSON de Newline-Delimited (el valor predeterminado es el texto sin formato) |
--no-color | No coloree la salida de texto |
--force-color | La salida redirigida de la fuerza tiene color ANSI (a menos que también se especifique --no-color ) |
workspace list
Lista de espacios de trabajo disponibles.
Ejemplo:
seqcli workspace list
Opción | Descripción |
---|---|
-t , --title=VALUE | El título de los espacios de trabajo para enumerar |
-i , --id=VALUE | La identificación de un solo espacio de trabajo para enumerar |
-o , --owner=VALUE | La identificación del usuario para enumerar los espacios de trabajo; Por defecto, los espacios de trabajo compartidos son listd |
--json | La salida de impresión en JSON de Newline-Delimited (el valor predeterminado es el texto sin formato) |
--no-color | No coloree la salida de texto |
--force-color | La salida redirigida de la fuerza tiene color ANSI (a menos que también se especifique --no-color ) |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
workspace remove
Elimine un espacio de trabajo del servidor.
Ejemplo:
seqcli workspace remove -t 'My Workspace'
Opción | Descripción |
---|---|
-t , --title=VALUE | El título de los espacios de trabajo para eliminar |
-i , --id=VALUE | La identificación de un solo espacio de trabajo para eliminar |
-o , --owner=VALUE | La identificación del usuario para eliminar los espacios de trabajo; Por defecto, se eliminan los espacios de trabajo compartidos |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
workspace update
Actualizar un espacio de trabajo existente.
Ejemplo:
seqcli workspace update --json '{...}'
Opción | Descripción |
---|---|
--json=VALUE | El espacio de trabajo actualizado en formato JSON; Esto se puede producir usando seqcli workspace list --json |
--json-stdin | Lea el espacio de trabajo actualizado como JSON de STDIN |
-s , --server=VALUE | La URL del servidor SEQ; Por defecto, se utilizará el valor de configuración connection.serverUrl |
-a , --apikey=VALUE | La clave API para usar al conectarse al servidor; de forma predeterminada el valor de configuración connection.apiKey |
--profile=VALUE | Un perfil de conexión para usar; De forma predeterminada, la connection.serverUrl y connection.apiKey Se utilizarán los valores de configuración |
El comando seqcli ingest
se puede usar para analizar los registros de texto planos en eventos de registro estructurados.
seqcli ingest -x " {@t:timestamp} [{@l:level}] {@m:*}{:n}{@x:*} "
El argumento -x
anterior es un patrón de extracción que analizará eventos como:
2018-02-21 13:29:00.123 +10:00 [ERR] The operation failed
System.DivideByZeroException: Attempt to divide by zero
at SomeClass.SomeMethod()
Los patrones de extracción tienen una sintaxis simple de alto nivel:
Hello, world!
coincidirá con las declaraciones de registro que se forman solo de este saludo,{curly braces}
es una expresión de coincidencia que identifica una parte del evento a extraer, y{{
coincidirá con el texto literal {
, y }}
coincidencias }
.Las expresiones de coincidencia tienen el formulario:
{name:matcher}
Tanto el nombre como el matcher son opcionales, pero uno u otro debe especificarse. Por lo tanto, {@t:timestamp}
especifica un nombre de @t
y timestamp
de valor de valor, {IPAddress}
Especifica solo un nombre, y {:n}
solo un valor (en este caso el nuevo combate incorporado).
El nombre es el nombre de la propiedad a extraer; Hay cuatro nombres de propiedad incorporados que obtienen un manejo especial:
@t
- la marca de tiempo del evento@m
- El mensaje textual asociado con el evento@l
- El nivel del evento@x
- La excepción o la redacción asociada con el evento Otros nombres de propiedad se adjuntan a la carga útil del evento, por lo que {Elapsed:dec}
extraerá una propiedad llamada Elapsed
, utilizando el Micher decimal dec
.
Las expresiones de coincidencia sin nombre se consumen de la entrada, pero no se agregan a la carga útil del evento.
Los Matchers identifican fragmentos del evento de entrada.
Se necesitan diferentes combinadores para que un texto como 200OK
pueda separarse en propiedades separadas, es decir {StatusCode:nat}{Status:alpha}
. Aquí, el Matcher nat
(Número natural) también coacciona el resultado en un valor numérico, de modo que se adjunta a la carga útil del evento numéricamente como 200
en lugar del texto "200"
.
Hay tres tipos de matchers:
alpha
y nat
están incorporados nombrados Matchers.*
, **
y So-On, son Matchers de contenido no grueso ; Estos coincidirán con cualquier texto hasta el siguiente elemento de patrón ( *
), los siguientes dos elementos coinciden y SO-ON. Vimos esto en acción con los elementos {@m:*}{:n}
en el ejemplo: el mensaje es todo el texto hasta la próxima nueva línea.=
, como {Phone:={:nat}-{:nat}-{:nat}}
. Esto extraerá fragmentos de texto como 123-456-7890
en la propiedad Phone
.igualador | Descripción | Ejemplo |
---|---|---|
* , ** , ... | Contenido no grisero | |
alpha | Una o más letras | Abc |
alphanum | Una o más letras o números | a1b2 |
dec | Un número decimal | 12.345 |
ident | Un identificador de estilo C | countOfMatches |
int | Un entero | -123 |
iso8601dt | Una fecha de fecha ISO-8601 | 2020-01-28T13:50:01.123 |
level | Un nombre de nivel de registro | INF |
line | Cualquier contenido de una sola línea | one line! |
n | Un carácter o secuencia de nueva línea | |
nat | Un número no negativo | 123 |
s | Uno o más caracteres de espacio o tabulación | |
serilogdt | Un DateTeT en el formato de registro de archivo de serilog predeterminado | 2020-01-28 13:50:01.123 +10:00 |
syslogdt | Una fecha y hora en formato syslog | Dec 8 09:12:13 |
t | Un solo personaje de pestaña | |
timestamp | Una hora de fecha en cualquier formato reconocido | |
token | Cualquier secuencia de caracteres que no son de espacio para blancos | 1+x$3 |
trailingident | Contenido multilínea con líneas de arrastre sangrantes | |
unixdt | Una fecha y hora en formato de tiempo UNIX de admitir segundos (10 dígitos) o milisegundos (12 dígitos) | 1608694199.999 |
w3cdt | Un par de Fecha/Hora del formato de registro W3C | 2019-04-02 05:18:01 |
Los patrones de extracción se procesan de izquierda a derecha. Cuando se encuentra el primer patrón no coincidente, la extracción se detiene; Cualquier texto restante que no pueda coincidir se adjuntará al evento resultante en una propiedad @unmatched
.
Los eventos de varias líneas se manejan buscando líneas que comiencen con el primer elemento del patrón de extracción que se utilizará. Esto funciona bien si la primera línea de cada evento comienza con algo inequívoco como una marca de tiempo iso8601dt
; Si las líneas comienzan con una sintaxis menos específica, los primeros elementos del patrón de extracción podrían agruparse para identificar el inicio de los eventos con mayor precisión:
{:=[{@t} {@l}]} {@m:*}
Aquí el texto literal [
, un espacio de token de marca de tiempo, espacio adyacente
, nivel y cierre ]
se agrupan para que constituyan un elemento de patrón lógico único para identificar el inicio de los eventos.
Cuando los registros se transmiten a seqcli ingest
en tiempo real, se aplica una fecha límite de 10 ms, dentro de la cual se debe recibir cualquier línea de salida que componiera el evento.
journalctl -f -n 0 |
seqcli ingest -x " {@t:syslogdt} {host} {ident:*}: {@m:*}{:n} " --invalid-data=ignore
/var/log/syslog
tail -c 0 -F /var/log/syslog |
seqcli ingest -x " {@t:syslogdt} {host} {ident:*}: {@m:*}{:n} "
Este ejemplo ingiere archivos de registro en el formato:
# Fields: date time s-ip cs-method cs-uri-stem cs-uri-query s-port cs-username c-ip cs(User-Agent)
cs(Referer) sc-status sc-substatus sc-win32-status sc-bytes cs-bytes time-taken
El patrón de extracción está envuelto en el ejemplo para fines de visualización, y debe aparecer todo en un argumento de una cadena cuando se invoca.
seqcli ingest -i http.log --invalid-data=ignore -x " {@t:w3cdt} {ServerIP} {@m:={Method} {RequestPath}}
{Query} {Port:nat} {Username} {ClientIP} {UserAgent} {Referer} {StatusCode:nat} {Substatus:nat}
{Win32Status:nat} {ResponseBytes:nat} {RequestBytes:nat} {Elapsed}{:n} "
Un patrón anidado {@m:=
se usa para recopilar una subcadena de la línea de registro para la visualización como mensaje del evento.
La familia de comandos seqcli * update
permite realizar actualizaciones arbitrarias para muchos tipos de entidades complejas.
Los comandos update
, como seqcli signal update
que se muestra en el ejemplo a continuación, reciben una representación JSON actualizada de una entidad a través de STDIN
.
Esto funciona particularmente bien con herramientas como jq
y conchas modernas con soporte nativo de JSON, como PowerShell:
PS > $warnings = (seqcli signal list -i signal-m33302 --json | ConvertFrom-Json)
PS > $warnings.Title
Warnings
PS > $warnings.Title = "Alarms"
PS > (echo $warnings | ConvertTo-Json) | seqcli signal update --json-stdin
PS > seqcli signal list -i signal-m33302 --json
{"Title": "Alarms", "Description": "Automatically created", "Filters": [{"De...