tenzir

Name: tenzir
Author: tenzir

github.com/tenzirデータ・データベース357 回インストール1 日前に更新

リポジトリ

tenzir について

Tenzirを使う開発者やセキュリティデータチーム向けのドキュメント案内スキルです。質問に応じてガイド、TQLリファレンス、連携手順、チュートリアル、設計解説へ案内し、回答前に該当ページを確認するよう促します。

主な機能

01質問の種類に応じた文書案内
02TQLの演算子と関数の索引
03データ入出力連携の説明
04セキュリティデータ処理ガイド
05チュートリアルと設計概念

活用シーン

01TQLの構文と例を調べる
02データ収集や出力連携を設定する
03セキュリティイベント処理のパイプラインを計画する

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/tenzir/skills --skill tenzir

インストール後、Claude Code で/tenzirを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

explanations.md

guides.md

explanations/

configuration.md

data-model.md

deployment.md

detections.md

encryption.md

enrichment.md

executor.md

glossary.md

language.md

node.md

normalization.md

packages.md

pipeline.md

platform.md

secrets.md

explanations/platform/

data-flow.md

guides/

ai-workbench.md

analyze.md

guides/ai-workbench/

use-agent-skills.md

guides/analyze/

aggregate-event-streams.md

calculate-aggregate-statistics.md

find-cardinality-spikes.md

find-unseen-and-rare-values.md

identify-distribution-drift.md

set-adaptive-thresholds-from-a-baseline.md

shape-aggregation-results.md

window-event-streams.md

guides/basic-usage/

manage-a-pipeline.md

詳細

Tenzir ドキュメントマップ

セキュリティデータパイプラインプラットフォームです。

このスキルの使い方

質問の種類に応じて、ドキュメントを参照してください。

質問の種類	参照先
「〜するには？」というタスク	ガイド — タスク別にまとめられた手順
オペレーターまたは関数の構文	オペレーターインデックスまたは関数インデックスを確認し、該当するページを参照します
インテグレーションの設定（Splunk、Kafka、S3…）	インテグレーション — 製品ごとの設定とパイプラインの例
概念（ノード、パイプライン、デプロイ）	解説 — アーキテクチャと設計
基礎から学ぶ	チュートリアル — ガイド付きのレッスン
TQL 言語のルール	言語、式、ステートメント

回答する前に、必ず関連するページを読んでください。構文を独自に考案するのではなく、ドキュメントにある TQL の例を優先してください。

ドキュメント以外の情報

このスキルに含まれるのはドキュメントのみです。 Tenzir に関するその他の情報については、記憶を頼りに回答するのではなく、必要に応じて次の最新ページを取得してください。

トピック	参照先
リリースノート、「X はいつ追加／変更されたか」	https://tenzir.com/changelog.md
ブログ記事とお知らせ	https://tenzir.com/blog.md
ソリューションのユースケース	https://tenzir.com/solutions.md
会社、製品、イベント、その他すべて	https://tenzir.com/llms.txt — ページごとの Markdown リンクを含むサイト全体のインデックス

回答のパターン

オペレーターの構文に関する質問 — 「where はどのように動作しますか？」 → whereを読み、構文を説明して、ドキュメントの TQL の例を示します。

インテグレーションに関する質問 — 「Splunk にデータを送信するには？」 → Splunkを読み、ページにあるパイプラインの例を提示します。

タスクに関する質問 — 「syslog を解析するには？」 → 区切りテキストの解析と read_syslogを読みます。ガイドの方法とオペレーターリファレンスを組み合わせます。

ガイド

ガイドでは、特定の目標を達成するための実践的な手順を順を追って説明します。

はじめに

クイックスタート

ログ、アラート、柔軟性のないツールに困っていませんか？

概要

このガイドでは、Tenzir CLI をインストールして、パイプラインをローカルで実行する方法や、永続ノードをデプロイする方法を説明します。

アカウントを作成

パイプラインを実行

プラットフォーム経由、コマンドラインでの tenzir バイナリの使用、または設定ファイルを使ったコードとして、パイプラインを実行できます。

パイプラインを管理

このガイドでは、アプリまたは API を通じてパイプラインのライフサイクルを制御する方法を説明します。

セットアップ

概要

AI エージェントを導入し、Tenzir のエージェントスキルを設定して、独自の AI Workbench を構築します。

エージェントスキルを使用

概要

Tenzir Node はパイプラインを実行するための基盤です。

ノードをプロビジョニング

ノードのサイズを決定

ノードをデプロイ

ノードを設定

TLS を設定

API を起動

パフォーマンスを調整

概要

Tenzir Platform は、Tenzir Nodes のフリート管理コントロールプレーンとして機能します。

AWS にデプロイ

シナリオを選択

リバースプロキシを設定

内部サービスを設定

ID プロバイダーを設定する

データベースを設定する

Blob ストレージを設定する

シークレットストアを設定する

プラットフォームを実行する

組織を管理する

このガイドでは、Tenzir Platform で組織を作成、設定、削除する方法を説明します。

組織メンバーを管理する

このガイドでは、組織にメンバーを招待する方法、既存のメンバーを管理する方法、ロールベースの権限モデルについて説明します。

組織のワークスペースを管理する

このガイドでは、組織に属するワークスペースを作成、表示、削除する方法を説明します。

ワークスペースを設定する

プラットフォームのワークスペースは、ノード、シークレット、ダッシュボードを論理的にグループ化します。

ダッシュボードを設定する

静的ワークスペース用のダッシュボードを事前に定義できます。

エフェメラルノードを使用する

エフェメラルノードは、一時的なデプロイや自動スケーリングを行うデプロイに最適です。

収集

概要

ファイル、API、ブローカー、ストア、ネットワークからイベントとバイトを読み取ります。

ファイルを読み取り、監視する

HTTP と API 経由で取得する

メッセージブローカーから読み取る

データストアから読み取る

ネットワークからデータを取得する

解析

概要

バイトストリームとテキストフィールドを構造化イベントに変換します。

区切りテキストを解析する

バイナリデータを解析する

文字列フィールドを解析する

値を整える

整形

概要

後続の処理に備えて、イベントのフィールドとレコードを準備します。

値を変換する

文字列を操作する

イベントのタイムスタンプを正規化する

順序が前後したイベントを修復する

時間を使って計算する

リストを整形する

レコードを整形する

複雑なデータを再構成する

データ形式を変換する

正規化

概要

ソース固有のイベントを共通スキーマにマッピングします。

ASIM にマッピングする

CIM にマッピングする

ECS にマッピングする

OCSF にマッピングする

UDM にマッピングする

最適化

概要

パイプライン内のデータ量と処理負荷を削減します。

データをフィルタリングして選択する

データをスライスしてサンプリングする

イベントの重複を排除する

保護

概要

有用な構造を維持しながら、機密データの露出を制限します。

機密データをマスキングする

機密データを暗号化する

エンリッチ化

概要

元のイベントに含まれていないコンテキストを追加します。

ルックアップテーブルを使用する

アセットインベントリでエンリッチする

脅威インテリジェンスでエンリッチする

AI でイベントをエンリッチする

分析

概要

イベントストリームを要約し、現在のアクティビティを過去の挙動と比較します。

イベントストリームを集計する

集計結果を整形する

イベントストリームをウィンドウ化する

集計統計を計算する

未確認の値やまれな値を見つける

ベースラインから適応型しきい値を設定する

分布のドリフトを特定する

カーディナリティの急増を見つける

検知

概要

セキュリティアクティビティを照合し、検知結果をモデル化します。

TQL でイベントを照合する

OCSF で検知をモデル化する

時間ウィンドウを使って検知する

保存済みイベントからベースラインを作成する

周期的な挙動を検知する

マルチステージ検知器を作成する

Sigma ルールを実行する

Sigma ルールと OCSF の互換性を確認する

YARA でバイト列をスキャンする

保存

概要

後で検索、再生、分析できるようにイベントを永続化します。

パーティション分割されたファイルを書き込む

ノードにインポートする

利用可能なスキーマを表示する

保存データを変換する

検索

概要

保存済みのイベントをクエリし、結果の処理を続けます。

ノードからエクスポートする

ルーティング

概要

イベントストリームを必要とするシステムに配信します。

宛先に送信する

データをサーバーとして公開する

ストリームを分割・結合する

サブパイプラインでファンアウトする

パイプラインを負荷分散する

再生

概要

保存済みイベントをライブパイプラインに再度通します。

過去のイベントを再生する

運用

概要

ノード、パイプライン、ホストの挙動を調査します。

ノードを調査する

メトリクスを収集する

概要

コンパイルの問題、パイプラインの障害、リソースの増加、ノードの接続性を診断します。

フィールド値をデバッグする

コンパイル出力を調査する

パイプラインの遅延を調査する

メモリ使用量の増加を調査する

ストレージ使用量の増加を調査する

オフラインノードを再接続する

ビルド

パッケージをインストールする

独自のパッケージを作成する

パッケージを作成する

このガイドでは、ゼロからパッケージを作成する方法を説明します。

パッケージをテストする

このガイドでは、パッケージにテストを追加する方法を説明します。

オペレーターを追加する

このガイドでは、パッケージ用のユーザー定義オペレーター（UDO）を作成する方法を説明します。

パイプラインを追加する

このガイドでは、パッケージにデプロイ可能なパイプラインを追加する方法を説明します。

コンテキストを追加する

このガイドでは、パッケージにエンリッチメントコンテキストを追加する方法を説明します。

定数を追加する

このガイドでは、constants.tql ファイルでパッケージ全体の定数を定義し、パッケージ独自のオペレーターやパイプラインから、またそのパッケージを使用するあらゆるパイプラインから、pkg::$name として参照する方法を説明します。

入力を設定する

このガイドでは、入力を使ってパッケージを設定可能にする方法を説明します。

変更履歴を管理する

このガイドでは、tenzir-ship を使って変更履歴のエントリーを管理し、リリースを公開する方法を説明します。

パッケージを公開する

このガイドでは、パッケージを公開する方法を説明します。

テストを実行する

このガイドでは、tenzir-test フレームワークを使って既存の統合テストを実行する方法を説明します。

テストを作成する

このガイドでは、tenzir-test フレームワークを使って統合テストを作成する方法を説明します。

フィクスチャを実行する

このガイドでは、テストを実行せずにスタンドアロンモードでフィクスチャを起動する方法を説明します。

フィクスチャを作成する

このガイドでは、フィクスチャを作成してテストハーネスに組み込み、テストから使用する方法を説明します。

カスタムランナーを追加する

ランナーは、検出されたファイルをどのように実行するかを tenzir-test に指示します。

プロジェクトフックを設定する

このガイドでは、テストの近くに配置するセットアップやクリーンアップのタスク用に、tenzir-test のプロジェクトフックを設定する方法を説明します。

貢献する

行動規範

オープンで歓迎的な環境を育むため、私たち貢献者およびメンテナーは、年齢、体格、障害、民族、性的特徴、性自認とその表現、経験の度合い、学歴、社会経済的地位、国籍、容姿、人種、宗教、性的アイデンティティや指向にかかわらず、誰もがハラスメントを受けることなく、プロジェクトとコミュニティに参加できることを誓います。

Git と GitHub のワークフロー

以下の図は、ブランチモデルを視覚化したものです。

セキュリティポリシー

セキュリティは、私たちにとって重要な問題です。

構文ハイライトを設定する

エディターで構文をハイライト表示するための TQL 言語拡張機能をインストールします

ソースからビルドする

Tenzir は、C++23 コンパイラーを使用し、ビルドシステムとして CMake を採用しています。

その他

時間を扱う

このガイドは、テーマを絞ったタスクに分割しています。

チュートリアル

チュートリアルは、プロジェクトを完成させるための一連の手順を通して学べる、学習に重点を置いたレッスンです。

基礎

データのライフサイクルを学ぶ

セキュリティデータは、誰かが作成したテキストとして届き、検知、ダッシュボード、監査で利用できる形にしなければなりません。

慣用的な TQL を学ぶ

このチュートリアルでは、明確で効率的、かつ保守しやすい TQL の書き方を学びます。

開発

データソースを導入する

データソースの導入とは、ある製品の出力を、データライフサイクルの後続のすべての段階で利用できるイベントに変換することです。

エンリッチメントコンテキストを追加する

コンテキストはコードではなく、状態です。

アナリティクス

チャートでデータをプロットする

このチュートリアルでは、パイプラインを使ってデータをチャートとしてプロットする方法を学びます。

ClickHouse で OCSF レイクを構築する

あらゆるデータを受け入れるテーブルから、型付きカラム、スキップインデックス、コーデック、クラスごとの保持期間を備えた最適化済みのレイクまで、ClickHouse に OCSF イベントを保存します。

解説

解説では、Tenzir の高度な概念を全体像から説明します。

アーキテクチャ

デプロイ

このページでは、階層化された設計によってデータ処理と管理を分離する、Tenzir のデプロイアーキテクチャについて説明します。

パイプライン

Tenzir のパイプラインは、データフローを表すオペレーターの連鎖です。

ノード

ノードは、パイプラインを管理して実行する稼働中のプロセスです。

プラットフォーム

プラットフォームは、ノード群を管理する機能を提供します。

言語

TQL のデータフローモデル、ストリーミングとバッチのセマンティクス、異なるスキーマのイベントのサポートについて説明します。

エグゼキューター

Tenzir が TQL を実行計画にコンパイルし、融合された受け渡し、チャネル、サブパイプライン、並列ジョブを使ってオペレーターを実行する仕組みを説明します。

データモデル

Tenzir がイベントを列指向のバッチに保存し、形状や型の異なるイベントを並べて保持し、バッチを分割する代わりにビットマップで行を選択する仕組みを説明します。

概念

設定

このページでは、Tenzir CLI と Node の設定方法を説明します。

シークレット

オペレーターと関数では、認証トークン、パスワード、キー、URL などの機密値を引数としてシークレットを受け取ります。

正規化

Tenzir がすべてのソースをまず OCSF にマッピングし、そこから変換する理由

エンリッチメント

エンリッチメントとは、イベントにコンテキストデータを追加することです。

検知

Tenzir がセキュリティの証拠を照合、相関、モデル化し、検知結果として扱う仕組みを説明します。

パッケージ

このページでは、パッケージによってパイプライン、オペレーター、コンテキスト、サンプルをデプロイ可能な単位にまとめる方法を説明します。

暗号化

暗号化とは、キーを持つ人だけが元に戻せる暗号文へ値を変換することです。

ヘルプ

用語集

このページでは、Tenzir で扱うものの名称を定義します。コンポーネント、パイプラインが操作するエンティティ、そして私たちが提供する単位が含まれます。

リファレンス

リファレンスでは、Tenzir の仕組みについて、詳細な技術説明を提供します。

言語（TQL）

型システム

このページでは、自動推論に対応した強い型付けを提供する TQL の型システムについて説明します。

式

式は TQL の計算の中核を成します。

ステートメント

TQL プログラムは、ステートメントの並びで構成されます。

プログラム

TQL プログラムはステートメントを組み合わせ、実行可能なデータ処理ワークフローを構成します。

概要

Tenzir は、データが存在する場所でパイプラインの一部を実行します。

コンポーネント

設定

以下の設定例は、すべての Tenzir パッケージに付属しています。

Helm チャート

Tenzir Helm チャートは、Kubernetes クラスターに 1 つ以上の tenzir-node インスタンスをデプロイします。

設定

これらの設定は、Tenzir Platform を構成します。

コマンドラインインターフェース

Tenzir Platform のコマンドラインインターフェース（CLI）を使用すると、コマンドラインから Tenzir Platform を操作し、組織、ワークスペース、ノードを管理できます。

ツール

テストフレームワーク

tenzir-test ハーネスは、パイプライン、フィクスチャ、カスタムランナーの統合テストを検出して実行します。

Ship フレームワーク

tenzir-ship は、Python 3.12 以降を必要とする Python パッケージとして提供されます。

セキュリティ

AWS 認証

Tenzir の AWS オペレーターは、AWS SDK のデフォルト認証情報チェーン、OIDC ウェブ ID トークン、または静的認証情報を使用して AWS に認証します。

Azure 認証

Tenzir の Azure オペレーターは、Azure SDK のデフォルト認証情報チェーン、共有アカウントキー、アプリケーションのクライアントシークレット、またはワークロード ID フェデレーションを使用して Microsoft Entra ID に認証します。

API

概要

このリファレンスは OpenAPI 仕様から生成されています。

概要

このリファレンスは OpenAPI 仕様から生成されています。

ノードの状態を確認

post/ping

ノードの一覧表示

post/user/list-nodes

ノードの作成

post/user/create-node

ノード名の変更

post/user/rename-node

ノードの削除

post/user/delete-node

ノードトークンの取得

post/user/get-node-token

クライアント設定の生成

post/user/generate-client-config

ダウンロード URL の生成

post/user/generate-download-url

デモノードの作成

post/user/create-demo-node

デモノードの廃止

post/user/retire-demo-node

プロキシ

post/user/proxy

透過プロキシ

get/user/node-proxy/{tenantid}/{nodeid}/{httppath}

透過プロキシ

post/user/node-proxy/{tenantid}/{nodeid}/{httppath}

透過プロキシ

put/user/node-proxy/{tenantid}/{nodeid}/{httppath}

透過プロキシ

delete/user/node-proxy/{tenantid}/{nodeid}/{httppath}

透過プロキシ

patch/user/node-proxy/{tenantid}/{nodeid}/{httppath}

透過プロキシ

head/user/node-proxy/{tenantid}/{nodeid}/{httppath}

透過プロキシ

options/user/node-proxy/{tenantid}/{nodeid}/{httppath}

キャッシュ付きプロキシ

post/user/proxy-cached

パイプライン出力の読み取り

post/serve

保存

post/user/dashboard/store

取得

post/user/dashboard/get

複数のパイプライン出力を読み取る

post/serve-multi

一覧表示

post/user/dashboard/list

削除

post/user/dashboard/delete

追加

post/user/alert/add

新しいパイプラインを作成する

post/pipeline/create

既存のパイプラインを削除する

post/pipeline/delete

一覧表示

post/user/alert/list

削除

post/user/alert/delete

新しいパイプラインを起動する

post/pipeline/launch

パイプラインを一覧表示する

post/pipeline/list

既存のパイプラインの TTL をリセットする

post/pipeline/reset-ttl

パイプラインの状態を更新する

post/pipeline/update

外部ストアを追加する

post/user/secrets/add-external-store

デフォルトストアを設定する

post/user/secrets/select-store

外部ストアを削除する

post/user/secrets/delete-external-store

ストアを一覧表示する

post/user/secrets/list-stores

追加

post/user/secrets/add

更新

post/user/secrets/update

削除

post/user/secrets/remove

一覧表示

post/user/secrets/list

テナントを削除する

post/user/delete-tenant

テナント名を更新する

post/user/rename-tenant

テナントを切り替える

post/user/switch-tenant

ヘルス

get/user/health

ログイン情報を取得する

post/user/get-login-info

Web アプリキーを取得する

get/admin/webapp-key

テナントを作成する

post/admin/create-tenant

ユーザーキーを生成する

post/admin/generate-user-key

ノードを起動する

post/admin/spawn-node

テナントを一覧表示する

get/admin/global-tenant-list

テナントを削除する

post/admin/force-delete-tenant

接続性を確認する

post/admin/check-connectivy

テナントの所有者を更新する

post/admin/update-tenant

認証関数を追加する

post/admin/add-auth-function

認証関数を削除する

post/admin/delete-auth-function

オペレーター

Tenzir には、幅広い組み込みパイプラインオペレーターが用意されています。

関数

関数は式の中に記述され、位置引数や名前付き引数を受け取り、計算結果として値を生成します。

ノードインデックス

概要インデックス

プラットフォームインデックス

インデックス

カテゴリ別の演算子の一覧は、演算子インデックスをご覧ください。

カテゴリ別の関数の一覧は、関数インデックスをご覧ください。

ログインしてコメント

基本情報

作者: tenzir
リポジトリ: tenzir/skills
カテゴリ: データ・データベース
インストール数: 57
GitHub スター: 3

問題を報告