seqcli
Seq 클라이언트 명령줄 앱. 로깅( seqcli log
), 검색( search
), 테일링( tail
), 쿼리( query
) 및 JSON 또는 일반 텍스트 로그 파일 수집( ingest
) 등을 지원합니다.
Windows용 Seq 설치 프로그램에는 seqcli
포함되어 있습니다. 그렇지 않은 경우 운영 체제에 맞는 릴리스를 다운로드하십시오. 또는 dotnet
설치되어 있는 경우 다음을 사용하여 seqcli
전역 도구로 설치할 수 있습니다.
dotnet tool install --global seqcli
기본 서버 URL 및 API 키를 설정하려면 다음을 실행하세요.
seqcli config -k connection.serverUrl -v https://your-seq-server
seqcli config -k connection.apiKey -v your-api-key
API 키는 SeqCli.json
구성 파일에 저장됩니다. Windows에서는 DPAPI를 사용하여 암호화됩니다. Mac/Linux에서는 키가 현재 일반 텍스트로 저장되어 있습니다. API 키를 구성에 저장하는 대신 --apikey=
인수를 통해 각 명령에 전달할 수 있습니다.
seqcli
datalust/seqcli
아래의 Docker 컨테이너로도 사용할 수 있습니다.
docker run --rm datalust/seqcli:latest <command> [<args>]
로컬 머신의 docker 컨테이너에 있는 Seq에 연결하려면 머신의 IP 주소(localhost가 아님)를 사용하거나 --net host
사용하여 docker 호스트 네트워킹을 지정합니다.
Docker 네트워크 및 볼륨을 사용하여 해당 컨테이너 내에서 seqcli
에 액세스할 수 있는 로컬 파일 및 기타 컨테이너를 만듭니다.
SEQCLI_<setting path>
형식의 환경 변수를 지정하여 런타임 시 각 설정 값을 재정의할 수 있습니다. 여기에는 밑줄로 구분된 설정 이름의 점선 세그먼트마다 하나의 요소가 포함되어 있습니다.
예를 들어, connection.serverUrl
설정은 SEQCLI_CONNECTION_SERVERURL
변수로 재정의될 수 있습니다.
Seq 설정을 자동화하는 경우 seqcli
에서 사용할 API 키가 아직 없을 가능성이 있습니다. 초기 Seq 서버 구성 중에 firstRun.adminUsername
및 firstRun.adminPasswordHash
(또는 이에 상응하는 환경 변수 SEQ_FIRSTRUN_ADMINUSERNAME
및 SEQ_FIRSTRUN_ADMINPASSWORDHASH
)를 지정하여 관리자 계정의 초기 사용자 이름과 비밀번호를 설정할 수 있습니다. 이를 사용하여 API 키를 생성한 다음 나머지 seqcli
명령과 함께 API 키 토큰을 사용할 수 있습니다.
seqcli apikey create
명령은 --connect-username
및 --connect-password-stdin
허용하고 새 API 키 토큰을 STDOUT
에 인쇄합니다(PowerShell 구문은 아래에서 사용됨).
$user = "admin"
$pw = "thepassword"
$token = (
echo $pw |
seqcli apikey create `
-t CLI `
--permissions="Read,Write,Project,Organization,System" `
--connect-username $user --connect-password-stdin
)
CONTRIBUTING.md
참조하세요.
API 키로 연결할 때 허용되는 작업은 해당 API 키에 할당된 권한에 따라 결정됩니다.
명령에 필요한 권한을 확인하려면 해당 서버 API 작업의 '권한 요구' 열을 확인하세요. 예를 들어 apikey create
명령은 Write
권한이 필요한 POST api/apikeys
엔드포인트를 사용합니다.
모든 seqcli
명령은 동일한 패턴을 따릅니다.
seqcli <command> [<args>]
지원되는 명령의 전체 목록은 다음을 실행하여 볼 수 있습니다.
seqcli help
특정 명령에 대한 사용법 정보를 표시하려면 seqcli help <command>
실행하십시오. 예를 들면 다음과 같습니다.
seqcli help apikey create
이는 명령 그룹에도 적용됩니다. 모든 apikey
하위 명령을 나열하려면 다음을 실행하세요.
seqcli help apikey
apikey
apikey create
— 자동화 또는 수집을 위한 API 키를 생성합니다.apikey list
— 사용 가능한 API 키를 나열합니다.apikey remove
— 서버에서 API 키를 제거합니다.apikey update
— 기존 API 키를 업데이트합니다.app
app define
— .NET [SeqApp]
플러그인에 대한 앱 정의를 생성합니다.app install
— 앱 패키지를 설치합니다.app list
— 설치된 앱 패키지를 나열합니다.app run
— .NET [SeqApp]
플러그인을 호스팅합니다.app uninstall
— 앱 패키지를 제거합니다.app update
— 설치된 앱 패키지를 업데이트합니다.appinstance
appinstance create
— 설치된 앱의 인스턴스를 생성합니다.appinstance list
— 설치된 앱의 인스턴스를 나열합니다.appinstance remove
— 서버에서 앱 인스턴스를 제거합니다.appinstance update
— 기존 앱 인스턴스를 업데이트합니다.bench
— 쿼리 성능을 측정합니다.config
— SeqCli.json
파일의 필드를 보고 설정합니다. 모든 필드를 나열하려면 인수 없이 실행하세요.dashboard
dashboard list
— 대시보드를 나열합니다.dashboard remove
— 서버에서 대시보드를 제거합니다.dashboard render
— 대시보드 차트에서 CSV 또는 JSON 결과 집합을 생성합니다.expressionindex
expressionindex create
— 표현식 인덱스를 생성합니다.expressionindex list
— 표현식 인덱스를 나열합니다.expressionindex remove
— 서버에서 표현식 인덱스를 제거합니다.feed
feed create
— NuGet 피드를 생성합니다.feed list
— NuGet 피드를 나열합니다.feed remove
— 서버에서 NuGet 피드를 제거합니다.feed update
— 기존 NuGet 피드를 업데이트합니다.help
— 사용 가능한 명령에 대한 정보를 표시합니다.index
index list
— 인덱스를 나열합니다.index suppress
— 인덱스를 억제합니다.ingest
— 파일 또는 STDIN
에서 로그 이벤트를 보냅니다.license apply
— Seq 서버에 라이센스를 적용합니다.log
— 구조화된 로그 이벤트를 서버로 보냅니다.node
node demote
— 현재 리더 노드의 강등을 시작합니다.node health
— Seq 노드의 /health
끝점을 조사하고 반환된 HTTP 상태 코드를 인쇄하거나 끝점을 쿼리할 수 없는 경우 'Unreachable'을 인쇄합니다.node list
— Seq 클러스터의 노드를 나열합니다.print
— 파일 또는 STDIN
에서 CLEF/JSON 형식으로 이벤트를 예쁘게 인쇄합니다.profile
profile create
— 연결 프로필을 생성하거나 교체합니다.profile list
— 연결 프로필을 나열합니다.profile remove
— 연결 프로필을 제거합니다.query
— SQL 쿼리를 실행하고 결과를 CSV 형식으로 받습니다.retention
retention create
— 보존 정책을 생성합니다.retention list
— 보존 정책을 나열합니다.retention remove
— 서버에서 보존 정책을 제거합니다.retention update
— 기존 보존 정책을 업데이트합니다.sample
sample ingest
— 샘플 이벤트를 Seq 인스턴스에 기록합니다.sample setup
— 샘플 대시보드, 신호, 사용자 등으로 Seq 인스턴스를 구성합니다.search
— 특정 필터와 일치하는 로그 이벤트를 검색합니다.setting
setting clear
— 런타임 구성 가능 서버 설정을 지웁니다.setting names
— 지원되는 모든 설정의 이름을 인쇄합니다.setting set
— 런타임 구성 가능 서버 설정을 변경합니다.setting show
— 런타임 구성 가능한 서버 설정의 현재 값을 인쇄합니다.signal
signal create
— 신호를 생성합니다.signal import
— 줄 바꿈으로 구분된 JSON 형식으로 신호를 가져옵니다.signal list
— 사용 가능한 신호를 나열합니다.signal remove
— 서버에서 신호를 제거합니다.signal update
— 기존 신호를 업데이트합니다.tail
— 필터와 일치하는 로그 이벤트를 스트리밍합니다.template
template export
— 엔터티를 템플릿 파일로 내보냅니다.template import
— 템플릿 파일에서 엔터티를 가져옵니다.user
user create
— 사용자를 생성합니다.user list
— 사용자를 나열합니다.user remove
— 서버에서 사용자를 제거합니다.user update
— 기존 사용자를 업데이트합니다.version
— 현재 실행 가능한 버전을 인쇄합니다.workspace
workspace create
— 작업 공간을 생성합니다.workspace list
— 사용 가능한 작업 공간을 나열합니다.workspace remove
— 서버에서 작업공간을 제거합니다.workspace update
— 기존 작업공간을 업데이트합니다.apikey create
자동화 또는 수집을 위한 API 키를 만듭니다.
예:
seqcli apikey create -t 'Test API Key' -p Environment=Test
옵션 | 설명 |
---|---|
-t , --title=VALUE | API 키의 제목 |
--token=VALUE | 사전 할당된 API 키 토큰입니다. 기본적으로 새 토큰이 생성되어 STDOUT 에 기록됩니다. |
-p , --property=NAME=VALUE | 이름/값 속성을 지정합니다. 예: -p Customer=C123 -p Environment=Production |
--filter=VALUE | 들어오는 이벤트에 적용할 필터 |
--minimum-level=VALUE | 허용할 최소 이벤트 수준/심각도입니다. 기본값은 모든 이벤트를 수락하는 것입니다. |
--use-server-timestamps | 클라이언트가 제공한 타임스탬프를 버리고 서버 시계 값을 사용합니다. |
--permissions=VALUE | API 키에 위임할 권한을 쉼표로 구분한 목록입니다. 유효한 권한은 Ingest (기본값), Read , Write , Project 및 System 입니다. |
--connect-username=VALUE | 연결할 사용자 이름으로, 주로 첫 번째 API 키를 설정할 때 유용합니다. '개별' 구독이 있는 서버는 이 옵션을 사용하여 하나의 동시 요청만 허용합니다. |
--connect-password=VALUE | connect-username 이 지정되면 해당 비밀번호가 |
--connect-password-stdin | connect-username 이 지정되면 STDIN 에서 해당 비밀번호를 읽습니다. |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
--json | 줄 바꿈으로 구분된 JSON으로 출력 인쇄(기본값은 일반 텍스트) |
--no-color | 텍스트 출력에 색상을 지정하지 마세요. |
--force-color | 강제로 리디렉션된 출력이 ANSI 색상을 갖도록 합니다( --no-color 도 지정하지 않는 한). |
apikey list
사용 가능한 API 키를 나열합니다.
예:
seqcli apikey list
옵션 | 설명 |
---|---|
-t , --title=VALUE | 나열할 API 키의 제목 |
-i , --id=VALUE | 나열할 단일 API 키의 ID |
--json | 줄 바꿈으로 구분된 JSON으로 출력 인쇄(기본값은 일반 텍스트) |
--no-color | 텍스트 출력에 색상을 지정하지 마세요. |
--force-color | 강제로 리디렉션된 출력이 ANSI 색상을 갖도록 합니다( --no-color 도 지정하지 않는 한). |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
apikey remove
서버에서 API 키를 제거합니다.
예:
seqcli apikey remove -t 'Test API Key'
옵션 | 설명 |
---|---|
-t , --title=VALUE | 제거할 API 키의 제목 |
-i , --id=VALUE | 제거할 단일 API 키의 ID |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
apikey update
기존 API 키를 업데이트합니다.
예:
seqcli apikey update --json '{...}'
옵션 | 설명 |
---|---|
--json=VALUE | JSON 형식의 업데이트된 API 키입니다. 이는 seqcli apikey list --json 사용하여 생성할 수 있습니다. |
--json-stdin | STDIN 에서 업데이트된 API 키를 JSON으로 읽습니다. |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
app define
.NET [SeqApp]
플러그인에 대한 앱 정의를 생성합니다.
예:
seqcli app define -d "./bin/Debug/netstandard2.2"
옵션 | 설명 |
---|---|
-d , --directory=VALUE | .NET Standard 어셈블리가 포함된 디렉터리입니다. 기본값은 현재 디렉토리 |
--type=VALUE | [SeqApp] 플러그인 유형 이름. 기본적으로 이 속성으로 표시된 단일 유형에 대한 어셈블리를 검색합니다. |
--indented | 들여쓰기를 사용하여 여러 줄에 걸쳐 정의 형식을 지정합니다. |
app install
앱 패키지를 설치합니다.
예:
seqcli app install --package-id 'Seq.App.JsonArchive'
옵션 | 설명 |
---|---|
--package-id=VALUE | 설치할 앱의 패키지 ID |
--version=VALUE | 설치할 패키지 버전입니다. 기본값은 최신 버전을 설치하는 것입니다. |
--feed-id=VALUE | 패키지를 설치할 NuGet 피드의 ID입니다. 피드가 하나만 구성된 경우 생략될 수 있습니다. |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
--json | 줄 바꿈으로 구분된 JSON으로 출력 인쇄(기본값은 일반 텍스트) |
--no-color | 텍스트 출력에 색상을 지정하지 마세요. |
--force-color | 강제로 리디렉션된 출력이 ANSI 색상을 갖도록 합니다( --no-color 도 지정하지 않는 한). |
app list
설치된 앱 패키지를 나열합니다.
예:
seqcli app list
옵션 | 설명 |
---|---|
--package-id=VALUE | 나열할 앱의 패키지 ID |
-i , --id=VALUE | 나열할 단일 앱의 ID |
--json | 줄 바꿈으로 구분된 JSON으로 출력 인쇄(기본값은 일반 텍스트) |
--no-color | 텍스트 출력에 색상을 지정하지 마세요. |
--force-color | 강제로 리디렉션된 출력이 ANSI 색상을 갖도록 합니다( --no-color 도 지정하지 않는 한). |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
app run
.NET [SeqApp]
플러그인을 호스팅합니다.
예:
seqcli tail --json | seqcli app run -d "./bin/Debug/netstandard2.2" -p [email protected]
옵션 | 설명 |
---|---|
-d , --directory=VALUE | .NET Standard 어셈블리가 포함된 디렉터리입니다. 기본값은 현재 디렉토리 |
--type=VALUE | [SeqApp] 플러그인 유형 이름. 기본적으로 이 속성으로 표시된 단일 유형에 대한 어셈블리를 검색합니다. |
-p , --property=NAME=VALUE | 앱의 이름/값 설정을 지정합니다. 예: -p [email protected] -p Subject="Alert!" |
--storage=VALUE | 앱별 데이터를 저장할 수 있는 디렉터리입니다. 기본값은 현재 디렉토리 |
-s , --server=VALUE | 앱 구성에만 사용되는 Seq 서버의 URL(서버에 연결되지 않음) 기본적으로 connection.serverUrl 값이 사용됩니다. |
--server-instance=VALUE | 앱 구성에만 사용되는 Seq 서버의 인스턴스 이름입니다. 기본값은 인스턴스 이름 없음입니다. |
-t , --title=VALUE | 앱 구성에만 사용되는 앱 인스턴스 제목입니다. 기본값은 자리 표시자 제목입니다. |
--id=VALUE | 앱 구성에만 사용되는 앱 인스턴스 ID입니다. 기본값은 자리 표시자 ID입니다. |
--read-env | https://docs.datalust.co/docs/seq-apps-in-other-언어s에 지정된 대로 환경 변수에서 앱 구성 및 설정을 읽습니다. --directory 및 --type을 제외한 모든 옵션을 무시합니다. |
app uninstall
앱 패키지를 제거합니다.
예:
seqcli app uninstall --package-id 'Seq.App.JsonArchive'
옵션 | 설명 |
---|---|
--package-id=VALUE | 제거할 앱 패키지의 패키지 ID |
-i , --id=VALUE | 제거할 단일 앱 패키지의 ID |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
app update
설치된 앱 패키지를 업데이트합니다.
예:
seqcli app update -n 'HTML Email'
옵션 | 설명 |
---|---|
-i , --id=VALUE | 업데이트할 설치된 단일 앱의 ID |
-n , --name=VALUE | 업데이트할 설치된 앱의 이름 |
--all | 설치된 모든 앱을 업데이트합니다. -i 또는 -n 과 호환되지 않음 |
--version=VALUE | 업데이트할 패키지 버전입니다. 기본값은 관련 피드의 최신 버전으로 업데이트하는 것입니다. |
--force | 대상 버전이 이미 설치되어 있어도 앱을 업데이트하세요. |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
--json | 줄 바꿈으로 구분된 JSON으로 출력 인쇄(기본값은 일반 텍스트) |
--no-color | 텍스트 출력에 색상을 지정하지 마세요. |
--force-color | 강제로 리디렉션된 출력이 ANSI 색상을 갖도록 합니다( --no-color 도 지정하지 않는 한). |
appinstance create
설치된 앱의 인스턴스를 만듭니다.
예:
seqcli appinstance create -t 'Email Ops' --app hostedapp-314159 -p [email protected]
옵션 | 설명 |
---|---|
-t , --title=VALUE | 앱 인스턴스의 제목 |
--app=VALUE | 인스턴스화할 설치된 앱 패키지의 ID |
-p , --property=NAME=VALUE | 앱의 이름/값 설정을 지정합니다. 예: -p [email protected] -p Subject="Alert!" |
--stream[=VALUE] | 수집되는 이벤트를 이 앱 인스턴스로 스트리밍합니다. 선택적으로 스트리밍해야 하는 이벤트를 제한하는 신호 표현식을 허용합니다(예: signal-1,signal-2 |
--overridable=VALUE | 앱을 호출할 때 사용자가 재정의할 수 있는 설정 이름을 지정합니다. |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
--json | 줄 바꿈으로 구분된 JSON으로 출력 인쇄(기본값은 일반 텍스트) |
--no-color | 텍스트 출력에 색상을 지정하지 마세요. |
--force-color | 강제로 리디렉션된 출력이 ANSI 색상을 갖도록 합니다( --no-color 도 지정하지 않는 한). |
appinstance list
설치된 앱의 인스턴스를 나열합니다.
예:
seqcli appinstance list
옵션 | 설명 |
---|---|
-t , --title=VALUE | 나열할 앱 인스턴스의 제목 |
-i , --id=VALUE | 나열할 단일 앱 인스턴스의 ID |
--json | 줄 바꿈으로 구분된 JSON으로 출력 인쇄(기본값은 일반 텍스트) |
--no-color | 텍스트 출력에 색상을 지정하지 마세요. |
--force-color | 강제로 리디렉션된 출력이 ANSI 색상을 갖도록 합니다( --no-color 도 지정하지 않는 한). |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
appinstance remove
서버에서 앱 인스턴스를 제거합니다.
예:
seqcli appinstance remove -t 'Email Ops'
옵션 | 설명 |
---|---|
-t , --title=VALUE | 제거할 앱 인스턴스의 제목 |
-i , --id=VALUE | 제거할 단일 앱 인스턴스의 ID |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
appinstance update
기존 앱 인스턴스를 업데이트합니다.
예:
seqcli appinstance update --json '{...}'
옵션 | 설명 |
---|---|
--json=VALUE | JSON 형식의 업데이트된 앱 인스턴스입니다. 이는 seqcli appinstance list --json 사용하여 생성할 수 있습니다. |
--json-stdin | STDIN 에서 업데이트된 앱 인스턴스를 JSON으로 읽습니다. |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
bench
쿼리 성능을 측정합니다.
옵션 | 설명 |
---|---|
-r , --runs=VALUE | 실행할 실행 횟수입니다. 기본값은 10입니다. |
-c , --cases=VALUE | 실행할 사례 집합이 포함된 JSON 파일입니다. 표준 케이스 세트가 기본값입니다. |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
--start=VALUE | 쿼리할 ISO 8601 날짜/시간 |
--end=VALUE | 쿼리할 ISO 8601 날짜/시간 |
--reporting-server=VALUE | 벤치 결과를 보낼 Seq 서버의 주소 |
--reporting-apikey=VALUE | 보고 서버에 연결할 때 사용하는 API 키 |
--description=VALUE | 벤치 테스트 실행에 대한 선택적 설명 |
--with-ingestion | 벤치마크에 Seq로 이벤트 전송이 포함되어야 하나요? |
--with-queries | 벤치마크에 Seq 쿼리가 포함되어야 하나요? |
config
SeqCli.json
파일에서 필드를 보고 설정합니다. 모든 필드를 나열하려면 인수 없이 실행하세요.
옵션 | 설명 |
---|---|
-k , --key=VALUE | 필드(예: connection.serverUrl ) |
-v , --value=VALUE | 필드 값입니다. 지정하지 않으면 명령은 현재 값을 인쇄합니다. |
-c , --clear | 필드 지우기 |
dashboard list
대시보드를 나열합니다.
예:
seqcli dashboard list
옵션 | 설명 |
---|---|
-t , --title=VALUE | 나열할 대시보드의 제목 |
-i , --id=VALUE | 나열할 단일 대시보드의 ID입니다. |
-o , --owner=VALUE | 대시보드를 나열할 사용자의 ID입니다. 기본적으로 공유 대시보드가 나열됩니다. |
--json | 줄 바꿈으로 구분된 JSON으로 출력 인쇄(기본값은 일반 텍스트) |
--no-color | 텍스트 출력에 색상을 지정하지 마세요. |
--force-color | 강제로 리디렉션된 출력이 ANSI 색상을 갖도록 합니다( --no-color 도 지정하지 않는 한). |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
dashboard remove
서버에서 대시보드를 제거합니다.
예:
seqcli dashboard remove -i dashboard-159
옵션 | 설명 |
---|---|
-t , --title=VALUE | 제거할 대시보드의 제목 |
-i , --id=VALUE | 제거할 단일 대시보드의 ID |
-o , --owner=VALUE | 대시보드를 제거할 사용자의 ID입니다. 기본적으로 공유 대시보드는 제거됩니다. |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
dashboard render
대시보드 차트에서 CSV 또는 JSON 결과 세트를 생성합니다.
예:
seqcli dashboard render -i dashboard-159 -c 'Response Time (ms)' --last 7d --by 1h
옵션 | 설명 |
---|---|
-i , --id=VALUE | 렌더링할 단일 대시보드의 ID |
-c , --chart=VALUE | 렌더링할 대시보드의 차트 제목 |
--last=VALUE | 차트를 렌더링해야 하는 기간(예: 7d ) 이는 간격 경계에 맞춰 정렬됩니다. --last 또는 --start 및 --end 지정해야 합니다. |
--by=VALUE | 차트 데이터의 시간 조각 간격(예: 1h |
--start=VALUE | 쿼리할 ISO 8601 날짜/시간 |
--end=VALUE | 쿼리할 ISO 8601 날짜/시간 |
--signal=VALUE | 적용할 신호 표현식 또는 교차된 신호 ID 목록(예: signal-1,signal-2 |
--timeout=VALUE | 실행 시간 초과(밀리초) |
--json | 줄 바꿈으로 구분된 JSON으로 출력 인쇄(기본값은 일반 텍스트) |
--no-color | 텍스트 출력에 색상을 지정하지 마세요. |
--force-color | 강제로 리디렉션된 출력이 ANSI 색상을 갖도록 합니다( --no-color 도 지정하지 않는 한). |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
expressionindex create
표현식 인덱스를 만듭니다.
예:
seqcli expressionindex create --expression "ServerName"
옵션 | 설명 |
---|---|
-e , --expression=VALUE | 색인화할 표현식 |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
--json | 줄 바꿈으로 구분된 JSON으로 출력 인쇄(기본값은 일반 텍스트) |
--no-color | 텍스트 출력에 색상을 지정하지 마세요. |
--force-color | 강제로 리디렉션된 출력이 ANSI 색상을 갖도록 합니다( --no-color 도 지정하지 않는 한). |
expressionindex list
표현식 인덱스를 나열합니다.
예:
seqcli expressionindex list
옵션 | 설명 |
---|---|
-i , --id=VALUE | 나열할 단일 표현식 인덱스의 ID |
--json | 줄 바꿈으로 구분된 JSON으로 출력 인쇄(기본값은 일반 텍스트) |
--no-color | 텍스트 출력에 색상을 지정하지 마세요. |
--force-color | 강제로 리디렉션된 출력이 ANSI 색상을 갖도록 합니다( --no-color 도 지정하지 않는 한). |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
expressionindex remove
서버에서 표현식 인덱스를 제거합니다.
예:
seqcli expressionindex -i expressionindex-2529
옵션 | 설명 |
---|---|
-i , --id=VALUE | 제거할 표현식 인덱스의 ID |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
feed create
NuGet 피드를 만듭니다.
예:
seqcli feed create -n 'CI' --location="https://f.feedz.io/example/ci" -u Seq --password-stdin
옵션 | 설명 |
---|---|
-n , --name=VALUE | 피드의 고유한 이름 |
-l , --location=VALUE | 피드 위치 이는 NuGet v2 또는 v3 피드 URL이거나 Seq 서버의 로컬 파일 시스템 경로일 수 있습니다. |
-u , --username=VALUE | 인증이 필요한 경우 피드에 연결할 때 사용자 이름 Seq를 제공해야 합니다. |
-p , --password=VALUE | 인증이 필요한 경우 피드 비밀번호 --password-stdin 이 더 안전하다는 점에 유의하세요. |
--password-stdin | STDIN 에서 피드 비밀번호를 읽습니다. |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
--json | 줄 바꿈으로 구분된 JSON으로 출력 인쇄(기본값은 일반 텍스트) |
--no-color | 텍스트 출력에 색상을 지정하지 마세요 |
--force-color | 강제로 리디렉션된 출력이 ANSI 색상을 갖도록 합니다( --no-color 도 지정하지 않는 한). |
feed list
NuGet 피드를 나열합니다.
예:
seqcli feed list
옵션 | 설명 |
---|---|
-n , --name=VALUE | 나열할 피드의 이름 |
-i , --id=VALUE | 나열할 단일 피드의 ID |
--json | 줄 바꿈으로 구분된 JSON으로 출력 인쇄(기본값은 일반 텍스트) |
--no-color | 텍스트 출력에 색상을 지정하지 마세요. |
--force-color | 강제로 리디렉션된 출력이 ANSI 색상을 갖도록 합니다( --no-color 도 지정하지 않는 한). |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
feed remove
서버에서 NuGet 피드를 제거합니다.
예:
seqcli feed remove -n CI
옵션 | 설명 |
---|---|
-n , --name=VALUE | 제거할 피드의 이름 |
-i , --id=VALUE | 제거할 단일 피드의 ID |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
feed update
기존 NuGet 피드를 업데이트합니다.
예:
seqcli feed update --json '{...}'
옵션 | 설명 |
---|---|
--json=VALUE | JSON 형식의 업데이트된 NuGet 피드입니다. 이는 seqcli feed list --json 사용하여 생성할 수 있습니다. |
--json-stdin | STDIN 에서 업데이트된 NuGet 피드를 JSON으로 읽습니다. |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
help
사용 가능한 명령에 대한 정보를 표시합니다.
예:
seqcli help search
옵션 | 설명 |
---|---|
-m , --markdown | 문서에 사용할 마크다운 생성 |
index list
인덱스를 나열합니다.
예:
seqcli index list
옵션 | 설명 |
---|---|
-i , --id=VALUE | 나열할 단일 인덱스의 ID |
--json | 줄 바꿈으로 구분된 JSON으로 출력 인쇄(기본값은 일반 텍스트) |
--no-color | 텍스트 출력에 색상을 지정하지 마세요 |
--force-color | 강제로 리디렉션된 출력이 ANSI 색상을 갖도록 합니다( --no-color 도 지정하지 않는 한). |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
index suppress
인덱스를 억제합니다.
예:
seqcli index suppress -i index-2191448f1d9b4f22bd32c6edef752748
옵션 | 설명 |
---|---|
-i , --id=VALUE | 억제할 인덱스의 ID |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
ingest
파일 또는 STDIN
에서 로그 이벤트를 보냅니다.
예:
seqcli ingest -i log-*.txt --json --filter="@Level <> 'Debug'" -p Environment=Test
옵션 | 설명 |
---|---|
-i , --input=VALUE | * 와일드카드를 포함하여 수집할 파일. 지정하지 않으면 STDIN 사용됩니다. |
--invalid-data=VALUE | 잘못된 데이터 처리 방법 지정: fail (기본값) 또는 ignore |
-p , --property=NAME=VALUE | 이름/값 속성을 지정합니다. 예: -p Customer=C123 -p Environment=Production |
-x , --extract=VALUE | 일반 텍스트 로그에 적용할 추출 패턴( --json 이 지정된 경우 무시됨) |
--json | 이벤트를 JSON으로 읽습니다(기본값은 일반 텍스트로 가정). |
-f , --filter=VALUE | 이벤트의 하위 집합을 선택하는 필터 표현식 |
-m , --message=VALUE | 수집된 이벤트와 연결할 메시지입니다. https://messagetemplates.org 구문이 지원됩니다. |
-l , --level=VALUE | 수집된 이벤트와 관련된 수준 또는 심각도입니다. 이는 이벤트 자체에 존재하는 모든 레벨 정보를 재정의합니다. |
--send-failure=VALUE | 연결 실패 처리 방법 지정: fail (기본값), retry , continue 또는 ignore |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값이 사용됩니다. |
--batch-size=VALUE | 수집 끝점에 대한 각 요청에서 보낼 최대 이벤트 수입니다. 지정하지 않으면 값 100 이 사용됩니다. |
license apply
Seq 서버에 라이센스를 적용합니다.
예:
seqcli license apply --certificate="license.txt"
옵션 | 설명 |
---|---|
-c , --certificate=VALUE | 인증서 파일; 파일은 UTF-8 텍스트여야 합니다. |
--certificate-stdin | STDIN 에서 라이센스 인증서 읽기 |
--automatically-refresh | 라이센스가 구독용인 경우 주기적으로 datalust.co 확인하고 구독이 변경되거나 갱신되면 자동으로 인증서를 새로 고칩니다. |
-s , --server=VALUE | Seq 서버의 URL입니다. 기본적으로 connection.serverUrl 구성 값이 사용됩니다. |
-a , --apikey=VALUE | 서버에 연결할 때 사용할 API 키입니다. 기본적으로 connection.apiKey 구성 값이 사용됩니다. |
--profile=VALUE | 사용할 연결 프로필입니다. 기본적으로 connection.serverUrl 및 connection.apiKey 구성 값은 다음과 같습니다. |