【ツール活用｜実務向け】もう二度と手動でフィルタリングしない！DevOpsを加速する検索条件の保存テクニック

1. 導入: なぜ検索条件の保存がDevOpsで重要なのか？

DevOpsやインフラの現場では、日々膨大な量のデータに直面します。ログ、メトリクス、イベント、リソース情報、課題管理システムのチケットなど、これらの中から必要な情報を素早く、正確に見つけ出すことは、問題解決、パフォーマンス監視、セキュリティ監査において不可欠です。

しかし、毎回同じような条件を手動で入力して検索していませんか？
「あのエラーログ、特定のサービスと期間で絞り込みたい」「特定のクラスタでリソースを食っているPodはどれだ？」「障害発生時の特定のユーザーの操作履歴を追いたい」――このような定型的な検索を繰り返すのは、非常に非効率的であり、入力ミスによる見落としのリスクも伴います。

ここで役立つのが「検索条件の保存」です。よく使う検索条件を定義して保存しておけば、ワンクリックやシンプルなコマンド実行で、瞬時に必要な情報にアクセスできるようになります。これは単なる時間の節約にとどまらず、トラブルシューティングの迅速化、監視の効率化、そしてチーム全体の生産性向上に直結する、DevOps実践における強力な武器となります。

2. 基礎知識: 「検索条件の保存」とは何か？

「検索条件の保存」とは、特定のデータセットから目的の情報を抽出するためのフィルタリング条件（例: キーワード、期間、属性値、正規表現など）を定義し、名前をつけて永続的に保持する仕組みのことです。これにより、毎回条件を再入力する手間を省き、いつでも同じ条件で検索を実行できるようになります。

この概念は、様々なツールや技術で形を変えて存在します。

ログ管理・監視ツール (Kibana, Grafana, Splunkなど):
Kibanaの「Saved Searches」やGrafanaのダッシュボード変数、Splunkの「Reports」などがこれに該当します。特定のログパターンやメトリクスの閾値を保存し、すぐにダッシュボードやアラートとして活用できます。
データベース:
SQLの「VIEW」も一種の保存された検索条件と考えることができます。複雑なJOINやWHERE句を含むクエリをVIEWとして定義することで、単純なSELECT文で結果を取得できます。
シェルスクリプト:
コマンドエイリアスや関数として、複雑なコマンドラインオプションやパイプライン処理を保存し、短いコマンドで実行できます。
APIクライアント/スクリプト:
APIを呼び出す際の特定のクエリパラメータの組み合わせをスクリプトや設定ファイルに保存し、再利用します。

これらはすべて、「定型的な情報抽出を自動化・簡素化するメカニズム」という点で共通しています。

3. 実装/解決策: 具体的なアプローチ

「検索条件を保存する」という行為は、利用するツールによって異なりますが、DevOps・インフラエンジニアが汎用的に使える具体的なアプローチとしては、主に以下の2つが挙げられます。

設定ファイルとして管理する:
JSON, YAML, INIなどの形式で検索条件を記述し、スクリプトやツールがそれを読み込んで利用します。これにより、検索条件自体をコードとして管理（Configuration as Code）でき、バージョン管理システム（Git）での管理が可能になります。
シェルスクリプトの関数やエイリアスとして定義する:
頻繁に利用するコマンドの組み合わせや、特定のフィルタリング処理をシェルスクリプトの関数やエイリアスとして定義し、環境ファイル（例: .bashrc, .zshrc）に記述します。

今回は、より柔軟で構造的な管理が可能な「設定ファイルとして管理する」アプローチをPythonスクリプトとJSONファイルを使ってご紹介します。

4. サンプルプログラム: PythonとJSONで検索条件を管理する

ここでは、JSONファイルに複数の検索条件を定義し、Pythonスクリプトでそれを読み込み、特定のWeb API（ここではダミーのjsonplaceholderを使用）に対して検索リクエストを送信する例を示します。

検索条件定義ファイル (search_queries.json)

このJSONファイルに、名前付きで検索条件を定義します。キーは検索条件の名前、値はAPIに渡すクエリパラメータの辞書形式です。

{
“critical_errors_user_1”: {
“userId”: 1,
“status”: “error”,
“priority”: “high”
},
“recent_success_events_user_2”: {
“userId”: 2,
“status”: “success”,
“limit”: 10
},
“system_health_checks”: {
“tag”: “healthcheck”,
“level”: “info”,
“since”: “24h”
}
}

Pythonスクリプト (search_executor.py)

このスクリプトはsearch_queries.jsonを読み込み、指定された検索条件名に対応するパラメータを使ってAPIリクエストを実行します。

import requests
import json
import os

設定ファイルを読み込む関数
def load_search_queries(config_path=”search_queries.json”):
“””
指定されたパスから検索クエリ設定ファイルを読み込みます。
ファイルが存在しない場合は空の辞書を返します。
“””
if not os.path.exists(config_path):
print(f”エラー: 設定ファイル ‘{config_path}’ が見つかりません。”)
return {}
try:
with open(config_path, ‘r’, encoding=’utf-8′) as f:
return json.load(f)
except json.JSONDecodeError as e:
print(f”エラー: 設定ファイルのJSON形式が不正です: {e}”)
return {}
except Exception as e:
print(f”エラー: 設定ファイルの読み込み中に予期せぬエラーが発生しました: {e}”)
return {}

APIを検索する関数
def search_api(api_url, query_params):
“””
指定されたAPI URLにクエリパラメータを付けてGETリクエストを送信し、結果をJSON形式で返します。
リクエストが失敗した場合はNoneを返します。
“””
print(f”APIリクエストURL: {api_url}”)
print(f”クエリパラメータ: {query_params}”)
try:
response = requests.get(api_url, params=query_params)
response.raise_for_status() # HTTPエラー (4xx, 5xx) があれば例外を発生させる
return response.json()
except requests.exceptions.RequestException as e:
print(f”APIリクエスト中にエラーが発生しました: {e}”)
return None

if __name__ == “__main__”:
# 検索クエリ設定ファイル名
config_file = “search_queries.json”

# ダミーのAPIエンドポイント (実際には監視ツールやログ管理ツールなどのAPIを指定)
# 例: “https://https://api.example.com/logs”, “https://api.example.com/metrics”
TARGET_API_URL = “https://jsonplaceholder.typicode.com/posts” # サンプルとしてダミーAPIを使用

# 設定ファイルを読み込む
saved_queries = load_search_queries(config_file)

if not saved_queries:
print(“保存された検索クエリがありません。処理を終了します。”)
exit(1)

print(“— 保存された検索クエリ一覧 —“)
for name in saved_queries.keys():
print(f”- {name}”)
print(“—————————-“)

# 実行したい検索条件の名前を指定
# ここを変更して、異なる検索条件を試すことができます
query_name_to_execute = “critical_errors_user_1”

if query_name_to_execute in saved_queries:
print(f”\n— 検索クエリ ‘{query_name_to_execute}’ を実行中 —“)
query_params = saved_queries[query_name_to_execute]

# APIを呼び出す
results = search_api(TARGET_API_URL, query_params)

if results:
# 取得したデータの一部を表示 (ダミーAPIなので、ここでは最初の3件のみ表示)
print(“\n— 検索結果 (上位3件) —“)
for item in results[:3]:
# ダミーAPIのレスポンス構造に合わせて表示
print(f” ID: {item.get(‘id’)}, Title: {item.get(‘title’)[:50]}…”)
print(“—————————-“)
else:
print(“検索結果を取得できませんでした。”)
else:
print(f”エラー: 指定された検索クエリ ‘{query_name_to_execute}’ は見つかりませんでした。”)

実行方法

上記のsearch_queries.