ForHosting KIT · 文章作成・要約AI

正規表現に一致する行を抽出

Q: 一致した行は変更されますか？

いいえ。 文字と順序は保持されます。結合結果の行区切りだけをLFに統一します。

INFO、WARN、ERRORの行が混ざったログで^ERROR\bを指定すると、4行のうちエラーの2行だけが変更なく順番どおり残ります。1行ずつ判定するため、ワイルドカードが次の行にまたがることはありません。ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

計算例

入力した場合

パターン: ^ERROR\b

結果

結果: ERROR database unavailable ERROR request timed out
一致数: 2
総行数: 4

長いログ、レポート、設定ダンプ、構造化テキストから必要な情報だけを取り出すときに、正規表現に一致する行を抽出できます。テキスト、JavaScript正規表現のパターン、任意のフラグを指定すると、各行を個別に検査し、一致した行だけを元の順序で返します。LF、CRLF、CRの改行を認識し、選択した行の内容を保持したまま、一致数と検査した総行数も示します。モデルやネットワークに依存しない、ローカルで決定的な処理です。

必要な行を正確に選ぶパターンを作成します

パターンは完全な各行に対して個別に適用されるため、アンカーが特に役立ちます。対象の語が行頭になければならない場合は^で始め、末尾の文字が重要な場合は$で終えます。たとえば^ERROR\bは、ERRORSのようなラベルを除外しながら一般的なエラー行を選択します。\.csv$なら、その拡張子で終わるファイル名だけを残せます。

スラッシュ記法ではなく正規表現のソースを入力するため、/^WARN/ではなく^WARNと指定してください。任意のJavaScriptフラグは別の欄に入力します。iフラグは大文字と小文字を区別せず、その他の対応フラグはJavaScript標準の意味で動作します。選択された行は変更されず、相対的な順序も維持されます。

一致しない行は除かれますが、空白の削除、書き換え、並べ替え、重複排除、内容の解釈は行いません。そのため、重要な証拠を省く可能性がある要約ではなく、予測可能な原文の部分集合を自動処理で取得できます。

証拠を変えずにログや構造化テキストを絞り込みます

行単位のフィルタリングは、アプリケーションログ、コマンド出力、区切り形式のエクスポート、テストレポート、設定ファイルに適しています。開発担当者は、長いテスト実行から失敗したアサーションだけを残せます。運用パイプラインでは、タイムスタンプ、ホスト名、コンポーネントの接頭辞が既知の規則に一致するレコードを選べます。

照合は1行ずつ行われるため、ワイルドカードが次のレコードまで意図せず広がることはありません。LF、WindowsのCRLF、単独のCRを認識し、返却テキストでは安定したLF区切りを使用するので、後続の比較が環境によって変わりません。^$を使えば空行も明示的に選択できます。末尾の改行は区切りとして扱い、余分な空レコードとして数えません。

結合済み結果に加え、選択行の配列、一致数、総行数も返すため、再解析せずにスクリプトや検証へ利用できます。

パターンを検証して結果を安全に組み込みます

テキストまたはパターンがない場合や空の場合、未対応または重複したフラグ、互換性のないUnicodeモード、JavaScriptエンジンがコンパイルできない式は拒否されます。一致が0件の正常な応答にも意味があります。空の結果、空の行配列、一致数0、検査した行数が含まれます。

エッジ処理と無料ブラウザー処理の両方でメモリ使用量を予測できるよう、テキストとパターンには上限があります。パイプラインへ組み込む前に代表的なサンプルで新しい式を試し、形式が許す場合はアンカーを使い、不必要に曖昧な入れ子の繰り返しを避けてください。ネットワーク、乱数、時計、言語モデルを使わないため、同じ入力から常に同じ出力が得られます。

活用例

構造化レコードの選択

接頭辞、ステータス、ファイル名、識別子が指定の正規表現を満たす行を抽出します。

テスト出力の削減

長いビルドログから失敗したアサーションと診断マーカーを元の順序のまま保持します。

よくある質問

正規表現をスラッシュで囲む必要がありますか？

いいえ。 ^ERROR\bのようにパターンだけを送信してください。iなどのフラグは専用のフラグ欄に入力します。

パターンは各行とテキスト全体のどちらに適用されますか？

完全な各行に個別に適用されます。行内のどこかで一致すると、その行を1回だけ返します。

一致した行は変更されますか？

いいえ。文字と順序は保持されます。結合結果の行区切りだけをLFに統一します。

料金はいくらですか？

同じ決定的なフィルタリングをブラウザーでは無料で実行できます。

大文字と小文字を区別せずに探すにはどうしますか？

正規表現とは別にiのオプションを指定します。これで^errorでもERRORやErrorで始まる行が残ります。そのほかの一般的なオプションも通常どおりの意味で使えます。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/str/extract-lines-matching

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/str/extract-lines-matching \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"INFO server started\nERROR database unavailable\nWARN retrying\nERROR request timed out","pattern":"^ERROR\\b"}'

const res = await fetch("https://api.kit.forhosting.com/str/extract-lines-matching", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "INFO server started\nERROR database unavailable\nWARN retrying\nERROR request timed out",
    "pattern": "^ERROR\\b"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/str/extract-lines-matching",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "INFO server started\nERROR database unavailable\nWARN retrying\nERROR request timed out",
    "pattern": "^ERROR\\b"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/str/extract-lines-matching", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"INFO server started\\nERROR database unavailable\\nWARN retrying\\nERROR request timed out","pattern":"^ERROR\\\\b"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"INFO server started\nERROR database unavailable\nWARN retrying\nERROR request timed out","pattern":"^ERROR\\b"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/str/extract-lines-matching", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "text": "INFO server started\nERROR database unavailable\nWARN retrying\nERROR request timed out",
  "pattern": "^ERROR\\b"
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "str.extract_lines_matching",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

簡単な調査にはブラウザー版を無料で利用でき、自動化には成功リクエスト1回あたり$0.002のAPIを利用できます。

証拠を変えずにログや構造化テキストを絞り込みます

サポート担当者は、インシデントに短い抜粋を添付する前に、リクエストID、ステータスコード、重大度ラベルを抽出できます。

パターンを検証して結果を安全に組み込みます

このような場合は、空の結果を暗黙に返さずinvalid_inputを返すため、自動ルールの入力ミスと、正しくても一致がないパターンを区別できます。構造化JSONが必要なら行配列を、ファイル、チケット、別コマンドへ渡すなら結合結果を利用できます。API自動化は成功リクエストごとに$0.002、ブラウザーでの実行は無料です。

連携の活用例

エラーログ行の抽出

インシデントを確認する前に、エラー重大度で始まる行や特定のリクエストIDを含む行だけを残します。

技術的な質問

一致する行がない場合はどうなりますか？

正常に完了し、空の結果と行配列、0のmatched_count、検査行数を示すtotal_linesを返します。

KITの完全なドキュメントを見る →

正規表現に一致する行を抽出

無料で実行

計算例

必要な行を正確に選ぶパターンを作成します

証拠を変えずにログや構造化テキストを絞り込みます

パターンを検証して結果を安全に組み込みます

活用例

構造化レコードの選択

テスト出力の削減

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

お使いのスタックから呼び出す

リクエスト例

レスポンス例

料金

エラー

技術的な注記

証拠を変えずにログや構造化テキストを絞り込みます

パターンを検証して結果を安全に組み込みます

連携の活用例

エラーログ行の抽出

技術的な質問

ありがとう