devlogs 2.2.0__tar.gz → 2.2.2__tar.gz

{devlogs-2.2.0/src/devlogs.egg-info → devlogs-2.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devlogs
-Version: 2.2.0
+Version: 2.2.2
 Summary: Developer-focused logging library for Python with OpenSearch integration.
 Author-email: Dan Driscoll <dan@thedandriscoll.org>
 License: MIT License

{devlogs-2.2.0 → devlogs-2.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devlogs"
-version = "2.2.0"
+version = "2.2.2"
 description = "Developer-focused logging library for Python with OpenSearch integration."
 requires-python = ">=3.11"
 readme = "README.md"

{devlogs-2.2.0 → devlogs-2.2.2}/src/devlogs/cli.py

@@ -11,7 +11,7 @@ import typer
 from pathlib import Path
 
 from .config import load_config, set_dotenv_path, set_url, URLParseError, _parse_opensearch_url, parse_url, CollectorURLConfig
-from .formatting import format_timestamp
+from .formatting import format_timestamp, all_entries_today
 from .opensearch.client import (
 	get_opensearch_client,
 	check_connection,
@@ -31,6 +31,7 @@ from .opensearch.mappings import (
 from .opensearch.queries import normalize_log_entries, search_logs, tail_logs, get_last_errors
 from .retention import cleanup_old_logs, get_retention_stats
 from .jenkins.cli import jenkins_app
+from .version import __version__
 
 app = typer.Typer()
 app.add_typer(jenkins_app, name="jenkins")
@@ -50,10 +51,17 @@ def _apply_common_options(env: str = None, url: str = None):
 		set_url(url)
 
 
+def _version_callback(value: bool):
+	if value:
+		typer.echo(f"devlogs {__version__}")
+		raise typer.Exit()
+
+
 # Global callback to handle --env flag before any command runs (for backwards compatibility)
 @app.callback(invoke_without_command=True)
 def main_callback(
 	ctx: typer.Context,
+	version: bool = typer.Option(False, "--version", callback=_version_callback, is_eager=True, help="Show version and exit"),
 	env: str = ENV_OPTION,
 	url: str = URL_OPTION,
 ):
@@ -650,8 +658,10 @@ def diagnose(
 def tail(
 	operation_id: str = typer.Option(None, "--operation", "-o"),
 	area: str = typer.Option(None, "--area"),
+	component: str = typer.Option(None, "--component", "-c", help="Filter by component name"),
 	level: str = typer.Option(None, "--level"),
 	since: str = typer.Option(None, "--since"),
+	application: str = typer.Option(None, "--application", "-a", help="Filter by application name"),
 	limit: int = typer.Option(20, "--limit"),
 	follow: bool = typer.Option(False, "--follow", "-f"),
 	verbose: bool = typer.Option(False, "--verbose", "-v", help="Enable verbose output"),
@@ -698,12 +708,18 @@ def tail(
 				color=typer.colors.YELLOW,
 			)
 
+	effective_application = application or cfg.application
+
 	if verbose:
 		parts = []
+		if effective_application:
+			parts.append(f"application={effective_application}")
 		if operation_id:
 			parts.append(f"operation={operation_id}")
 		if area:
 			parts.append(f"area={area}")
+		if component:
+			parts.append(f"component={component}")
 		if level:
 			parts.append(f"level={level}")
 		if since:
@@ -728,7 +744,8 @@ def tail(
 				since=since,
 				limit=limit,
 				search_after=search_after,
-				application=cfg.application,
+				application=effective_application,
+				component=component,
 			)
 			_verbose_echo(f"Received {len(docs)} docs, next cursor={search_after}")
 			if verbose and docs:
@@ -791,9 +808,10 @@ def tail(
 			typer.echo(typer.style("No logs found.", dim=True), err=True)
 		first_poll = False
 
+		omit_date = all_entries_today(entries, use_utc=utc)
 		for entry_index, doc in enumerate(entries):
 			try:
-				timestamp = format_timestamp(doc.get("timestamp") or "", use_utc=utc)
+				timestamp = format_timestamp(doc.get("timestamp") or "", use_utc=utc, omit_date=omit_date)
 				entry_level = doc.get("level") or ""
 				entry_area = doc.get("area") or ""
 				entry_operation = doc.get("operation_id") or ""
@@ -820,9 +838,11 @@ def tail(
 def search(
 	q: str = typer.Option("", "--q", help="Search query"),
 	area: str = typer.Option(None, "--area"),
+	component: str = typer.Option(None, "--component", "-c", help="Filter by component name"),
 	level: str = typer.Option(None, "--level"),
 	operation_id: str = typer.Option(None, "--operation", "-o"),
 	since: str = typer.Option(None, "--since"),
+	application: str = typer.Option(None, "--application", "-a", help="Filter by application name"),
 	limit: int = typer.Option(50, "--limit"),
 	follow: bool = typer.Option(False, "--follow", "-f"),
 	utc: bool = typer.Option(False, "--utc", help="Display timestamps in UTC instead of local time"),
@@ -834,6 +854,7 @@ def search(
 
 	_apply_common_options(env, url)
 	client, cfg = require_opensearch()
+	effective_application = application or cfg.application
 	search_after = None
 	consecutive_errors = 0
 	max_errors = 3
@@ -852,7 +873,8 @@ def search(
 					since=since,
 					limit=limit,
 					search_after=search_after,
-					application=cfg.application,
+					application=effective_application,
+					component=component,
 				)
 			else:
 				docs = search_logs(
@@ -864,7 +886,8 @@ def search(
 					level=level,
 					since=since,
 					limit=limit,
-					application=cfg.application,
+					application=effective_application,
+					component=component,
 				)
 			entries = normalize_log_entries(docs, limit=limit)
 			consecutive_errors = 0
@@ -905,8 +928,9 @@ def search(
 			typer.echo(typer.style("No logs found.", dim=True), err=True)
 		first_poll = False
 
+		omit_date = all_entries_today(entries, use_utc=utc)
 		for doc in entries:
-			timestamp = format_timestamp(doc.get("timestamp") or "", use_utc=utc)
+			timestamp = format_timestamp(doc.get("timestamp") or "", use_utc=utc, omit_date=omit_date)
 			entry_level = doc.get("level") or ""
 			entry_area = doc.get("area") or ""
 			entry_operation = doc.get("operation_id") or ""
@@ -926,9 +950,11 @@ def search(
 def last_error(
 	q: str = typer.Option("", "--q", help="Search query"),
 	area: str = typer.Option(None, "--area"),
+	component: str = typer.Option(None, "--component", "-c", help="Filter by component name"),
 	operation_id: str = typer.Option(None, "--operation", "-o"),
 	since: str = typer.Option(None, "--since"),
 	until: str = typer.Option(None, "--until"),
+	application: str = typer.Option(None, "--application", "-a", help="Filter by application name"),
 	limit: int = typer.Option(1, "--limit"),
 	utc: bool = typer.Option(False, "--utc", help="Display timestamps in UTC instead of local time"),
 	env: str = ENV_OPTION,
@@ -939,6 +965,7 @@ def last_error(
 
 	_apply_common_options(env, url)
 	client, cfg = require_opensearch()
+	effective_application = application or cfg.application
 
 	try:
 		docs = get_last_errors(
@@ -950,7 +977,8 @@ def last_error(
 			since=since,
 			until=until,
 			limit=limit,
-			application=cfg.application,
+			application=effective_application,
+			component=component,
 		)
 		entries = normalize_log_entries(docs, limit=limit)
 	except (ConnectionFailedError, urllib.error.URLError) as e:
@@ -982,8 +1010,9 @@ def last_error(
 		typer.echo(typer.style("No errors found.", dim=True), err=True)
 		return
 
+	omit_date = all_entries_today(entries, use_utc=utc)
 	for doc in entries:
-		timestamp = format_timestamp(doc.get("timestamp") or "", use_utc=utc)
+		timestamp = format_timestamp(doc.get("timestamp") or "", use_utc=utc, omit_date=omit_date)
 		entry_level = doc.get("level") or ""
 		entry_area = doc.get("area") or ""
 		entry_operation = doc.get("operation_id") or ""

{devlogs-2.2.0 → devlogs-2.2.2}/src/devlogs/collector/schema.py

@@ -73,6 +73,7 @@ class DevlogsRecord:
     message: Optional[str] = None
     level: Optional[str] = None
     area: Optional[str] = None
+    operation_id: Optional[str] = None
     environment: Optional[str] = None
     version: Optional[str] = None
 
@@ -122,6 +123,8 @@ class DevlogsRecord:
             doc["level"] = self.level
         if self.area is not None:
             doc["area"] = self.area
+        if self.operation_id is not None:
+            doc["operation_id"] = self.operation_id
         if self.environment is not None:
             doc["environment"] = self.environment
         if self.version is not None:
@@ -246,6 +249,7 @@ def validate_record(data: Dict[str, Any]) -> DevlogsRecord:
     message = validate_string(data.get("message"), "message", required=False)
     level = validate_string(data.get("level"), "level", required=False)
     area = validate_string(data.get("area"), "area", required=False)
+    operation_id = validate_string(data.get("operation_id"), "operation_id", required=False)
     environment = validate_string(data.get("environment"), "environment", required=False)
     version = validate_string(data.get("version"), "version", required=False)
 
@@ -259,6 +263,7 @@ def validate_record(data: Dict[str, Any]) -> DevlogsRecord:
         message=message,
         level=level,
         area=area,
+        operation_id=operation_id,
         environment=environment,
         version=version,
         fields=fields,

devlogs-2.2.2/src/devlogs/formatting.py

@@ -0,0 +1,71 @@
+# Formatting utilities for devlogs output
+
+from datetime import datetime, timezone
+from typing import Iterable, Dict, Any
+
+
+def format_timestamp(timestamp_str: str | None, use_utc: bool = False, omit_date: bool = False) -> str:
+	"""
+	Format a timestamp string for display.
+
+	Args:
+		timestamp_str: ISO 8601 timestamp string (typically UTC with Z suffix) or None
+		use_utc: If True, display in UTC; if False, display in local time
+		omit_date: If True, show only time portion (HH:MM:SS.mmm)
+
+	Returns:
+		Formatted timestamp string
+	"""
+	if not timestamp_str:
+		return ""
+
+	try:
+		# Parse the ISO timestamp (handles Z suffix and +00:00 format)
+		dt = datetime.fromisoformat(timestamp_str.replace("Z", "+00:00"))
+
+		if use_utc:
+			dt_display = dt.astimezone(timezone.utc)
+			if omit_date:
+				return dt_display.strftime("%H:%M:%S.%f")[:-3] + "Z"
+			return dt_display.strftime("%Y-%m-%dT%H:%M:%S.%f")[:-3] + "Z"
+		else:
+			dt_display = dt.astimezone()
+			if omit_date:
+				return dt_display.strftime("%H:%M:%S.%f")[:-3]
+			return dt_display.strftime("%Y-%m-%dT%H:%M:%S.%f")[:-3]
+	except (ValueError, AttributeError):
+		# If parsing fails, return original string
+		return timestamp_str
+
+
+def all_entries_today(entries: Iterable[Dict[str, Any]], use_utc: bool = False) -> bool:
+	"""Check if all entries have timestamps from today.
+
+	Args:
+		entries: Log entries with 'timestamp' keys
+		use_utc: If True, compare against UTC date; otherwise local date
+
+	Returns:
+		True if all entries are from today (or have no timestamp)
+	"""
+	if use_utc:
+		today = datetime.now(timezone.utc).date()
+	else:
+		today = datetime.now().astimezone().date()
+	has_any = False
+	for entry in entries:
+		ts = entry.get("timestamp")
+		if not ts:
+			continue
+		has_any = True
+		try:
+			dt = datetime.fromisoformat(ts.replace("Z", "+00:00"))
+			if use_utc:
+				entry_date = dt.astimezone(timezone.utc).date()
+			else:
+				entry_date = dt.astimezone().date()
+			if entry_date != today:
+				return False
+		except (ValueError, AttributeError):
+			return False
+	return has_any

{devlogs-2.2.0 → devlogs-2.2.2}/src/devlogs/mcp/server.py

@@ -135,6 +135,10 @@ async def main():
                             "type": "string",
                             "description": "Filter by application area (e.g., 'api', 'database', 'auth')",
                         },
+                        "component": {
+                            "type": "string",
+                            "description": "Filter by component name (e.g., 'web', 'worker', 'jenkins')",
+                        },
                         "operation_id": {
                             "type": "string",
                             "description": "Filter by specific operation ID to see all logs for that operation",
@@ -161,6 +165,10 @@ async def main():
                             "items": {"type": ["string", "number"]},
                             "description": "Cursor from a previous response for pagination",
                         },
+                        "application": {
+                            "type": "string",
+                            "description": "Filter by application name",
+                        },
                     },
                 },
             ),
@@ -182,6 +190,10 @@ async def main():
                             "type": "string",
                             "description": "Filter by application area",
                         },
+                        "component": {
+                            "type": "string",
+                            "description": "Filter by component name",
+                        },
                         "level": {
                             "type": "string",
                             "description": "Filter by log level (DEBUG, INFO, WARNING, ERROR, CRITICAL)",
@@ -204,6 +216,10 @@ async def main():
                             "items": {"type": ["string", "number"]},
                             "description": "Cursor from a previous response for pagination",
                         },
+                        "application": {
+                            "type": "string",
+                            "description": "Filter by application name",
+                        },
                     },
                 },
             ),
@@ -217,6 +233,14 @@ async def main():
                             "type": "string",
                             "description": "The operation ID to summarize",
                         },
+                        "component": {
+                            "type": "string",
+                            "description": "Filter by component name",
+                        },
+                        "application": {
+                            "type": "string",
+                            "description": "Filter by application name",
+                        },
                     },
                     "required": ["operation_id"],
                 },
@@ -257,6 +281,14 @@ async def main():
                             "items": {"type": ["string", "number"]},
                             "description": "Cursor from a previous response for pagination",
                         },
+                        "component": {
+                            "type": "string",
+                            "description": "Filter by component name",
+                        },
+                        "application": {
+                            "type": "string",
+                            "description": "Filter by application name",
+                        },
                     },
                     "required": ["operation_id"],
                 },
@@ -271,6 +303,10 @@ async def main():
                             "type": "string",
                             "description": "Filter by application area",
                         },
+                        "component": {
+                            "type": "string",
+                            "description": "Filter by component name",
+                        },
                         "since": {
                             "type": "string",
                             "description": "ISO timestamp or relative duration like '1h' to filter operations after this time",
@@ -285,6 +321,10 @@ async def main():
                             "description": "Only show operations that had errors",
                             "default": False,
                         },
+                        "application": {
+                            "type": "string",
+                            "description": "Filter by application name",
+                        },
                     },
                 },
             ),
@@ -298,6 +338,10 @@ async def main():
                             "type": "string",
                             "description": "Filter by application area",
                         },
+                        "component": {
+                            "type": "string",
+                            "description": "Filter by component name",
+                        },
                         "since": {
                             "type": "string",
                             "description": "ISO timestamp or relative duration like '1h' to filter operations after this time",
@@ -321,6 +365,10 @@ async def main():
                             "description": "Only show operations that had errors",
                             "default": False,
                         },
+                        "application": {
+                            "type": "string",
+                            "description": "Filter by application name",
+                        },
                     },
                 },
             ),
@@ -339,6 +387,14 @@ async def main():
                             "description": "Minimum number of operations an area must have to be included",
                             "default": 1,
                         },
+                        "component": {
+                            "type": "string",
+                            "description": "Filter by component name",
+                        },
+                        "application": {
+                            "type": "string",
+                            "description": "Filter by application name",
+                        },
                     },
                 },
             ),
@@ -356,6 +412,10 @@ async def main():
                             "type": "string",
                             "description": "Filter by application area",
                         },
+                        "component": {
+                            "type": "string",
+                            "description": "Filter by component name",
+                        },
                         "since": {
                             "type": "string",
                             "description": "ISO timestamp or relative duration like '1h' to filter logs after this time",
@@ -379,6 +439,10 @@ async def main():
                             "description": "Include logs missing the signature field",
                             "default": False,
                         },
+                        "application": {
+                            "type": "string",
+                            "description": "Filter by application name",
+                        },
                     },
                 },
             ),
@@ -396,6 +460,10 @@ async def main():
                             "type": "string",
                             "description": "Filter by application area",
                         },
+                        "component": {
+                            "type": "string",
+                            "description": "Filter by component name",
+                        },
                         "operation_id": {
                             "type": "string",
                             "description": "Filter by specific operation ID",
@@ -413,6 +481,10 @@ async def main():
                             "description": "Maximum number of error entries to return (default: 1, max: 100)",
                             "default": 1,
                         },
+                        "application": {
+                            "type": "string",
+                            "description": "Filter by application name",
+                        },
                     },
                 },
             ),
@@ -434,6 +506,10 @@ async def main():
                             "type": "string",
                             "description": "Filter by application area",
                         },
+                        "component": {
+                            "type": "string",
+                            "description": "Filter by component name",
+                        },
                         "query": {
                             "type": "string",
                             "description": "Text search query to match against log messages, logger names, and features",
@@ -452,6 +528,10 @@ async def main():
                             "description": "Number of entries after the anchor (default: 20)",
                             "default": 20,
                         },
+                        "application": {
+                            "type": "string",
+                            "description": "Filter by application name",
+                        },
                     },
                     "required": ["anchor_timestamp"],
                 },
@@ -467,10 +547,14 @@ async def main():
             arguments = {}
 
         try:
-            client, index, application = _create_client_and_index()
+            client, index, config_application = _create_client_and_index()
         except RuntimeError as e:
             return _error_response(str(e), "InitializationError")
 
+        application = arguments.get("application") or config_application
+
+        component = arguments.get("component")
+
         if name == "search_logs":
             query = arguments.get("query")
             area = arguments.get("area")
@@ -495,6 +579,7 @@ async def main():
                     cursor=cursor,
                     sort_order="desc",
                     application=application,
+                    component=component,
                 )
                 entries = _normalize_entries(docs, limit=limit)
 
@@ -533,6 +618,7 @@ async def main():
                     limit=limit,
                     search_after=cursor,
                     application=application,
+                    component=component,
                 )
                 entries = _normalize_entries(docs, limit=limit)
 
@@ -554,7 +640,7 @@ async def main():
                 return _error_response("operation_id is required", "ValidationError")
 
             try:
-                summary = get_operation_summary(client, index, operation_id, application=application)
+                summary = get_operation_summary(client, index, operation_id, application=application, component=component)
 
                 if not summary:
                     return _json_response(
@@ -594,6 +680,7 @@ async def main():
                     limit=limit,
                     cursor=cursor,
                     application=application,
+                    component=component,
                 )
                 entries = _normalize_entries(docs, limit=limit)
 
@@ -623,6 +710,7 @@ async def main():
                     limit=limit,
                     with_errors_only=with_errors_only,
                     application=application,
+                    component=component,
                 )
 
                 return _json_response(
@@ -654,6 +742,7 @@ async def main():
                     order_by=order_by,
                     with_errors_only=with_errors_only,
                     application=application,
+                    component=component,
                 )
 
                 return _json_response(
@@ -676,6 +765,7 @@ async def main():
                     since=since,
                     min_operations=min_operations,
                     application=application,
+                    component=component,
                 )
 
                 return _json_response(
@@ -709,6 +799,7 @@ async def main():
                     min_count=min_count,
                     include_missing=include_missing,
                     application=application,
+                    component=component,
                 )
                 return _json_response(
                     data={"signatures": signatures},
@@ -738,6 +829,7 @@ async def main():
                     until=until,
                     limit=limit,
                     application=application,
+                    component=component,
                 )
                 entries = _normalize_entries(docs, limit=limit)
                 return _json_response(
@@ -775,6 +867,7 @@ async def main():
                     before=before,
                     after=after,
                     application=application,
+                    component=component,
                 )
                 entries = _normalize_entries(docs)
                 return _json_response(

{devlogs-2.2.0 → devlogs-2.2.2}/src/devlogs/opensearch/queries.py

@@ -32,7 +32,7 @@ def _build_time_range(since: Optional[str], until: Optional[str], since_inclusiv
 	return {"range": {"timestamp": range_query}}
 
 
-def _build_log_query(query=None, area=None, operation_id=None, level=None, since=None, until=None, since_inclusive: bool = True, until_inclusive: bool = True, application=None):
+def _build_log_query(query=None, area=None, operation_id=None, level=None, since=None, until=None, since_inclusive: bool = True, until_inclusive: bool = True, application=None, component=None):
 	filters = [
 		{
 			"bool": {
@@ -48,6 +48,8 @@ def _build_log_query(query=None, area=None, operation_id=None, level=None, since
 		filters.append({"term": {"application": application}})
 	if area:
 		filters.append({"term": {"area": area}})
+	if component:
+		filters.append({"term": {"component": component}})
 	if operation_id:
 		filters.append({"term": {"operation_id": operation_id}})
 	level_terms = _normalize_level_terms(level)
@@ -109,6 +111,7 @@ def _normalize_entry(doc: Dict[str, Any]) -> Dict[str, Any]:
 		"level": normalize_level(doc.get("level")),
 		"message": doc.get("message"),
 		"logger": doc.get("logger"),
+		"component": doc.get("component"),
 		"area": doc.get("area"),
 		"operation_id": doc.get("operation_id"),
 		"pathname": doc.get("pathname"),
@@ -128,7 +131,7 @@ def normalize_log_entries(docs: Iterable[Dict[str, Any]], limit: Optional[int] =
 	return entries
 
 
-def search_logs(client, index, query=None, area=None, operation_id=None, level=None, since=None, until=None, limit=50, application=None):
+def search_logs(client, index, query=None, area=None, operation_id=None, level=None, since=None, until=None, limit=50, application=None, component=None):
 	"""Search log entries with filters."""
 	body = {
 		"query": _build_log_query(
@@ -139,6 +142,7 @@ def search_logs(client, index, query=None, area=None, operation_id=None, level=N
 			since=since,
 			until=until,
 			application=application,
+			component=component,
 		),
 		"sort": [{"timestamp": "desc"}, {"_id": "desc"}],
 		"size": limit,
@@ -148,7 +152,7 @@ def search_logs(client, index, query=None, area=None, operation_id=None, level=N
 	return _hits_to_docs(hits)
 
 
-def get_last_errors(client, index, query=None, area=None, operation_id=None, since=None, until=None, limit=1, application=None):
+def get_last_errors(client, index, query=None, area=None, operation_id=None, since=None, until=None, limit=1, application=None, component=None):
 	"""Get the most recent error/critical log entries."""
 	base_query = _build_log_query(
 		query=query,
@@ -157,6 +161,7 @@ def get_last_errors(client, index, query=None, area=None, operation_id=None, sin
 		since=since,
 		until=until,
 		application=application,
+		component=component,
 	)
 	base_query.get("bool", {}).get("filter", []).append(
 		{"terms": {"level": ["error", "critical"]}}
@@ -191,6 +196,7 @@ def search_logs_page(
 	since_inclusive: bool = True,
 	until_inclusive: bool = True,
 	application=None,
+	component=None,
 ):
 	"""Search log entries with pagination support."""
 	body = {
@@ -204,6 +210,7 @@ def search_logs_page(
 			since_inclusive=since_inclusive,
 			until_inclusive=until_inclusive,
 			application=application,
+			component=component,
 		),
 		"sort": _build_sort(sort_order),
 		"size": limit,
@@ -217,7 +224,7 @@ def search_logs_page(
 	return docs, next_cursor
 
 
-def get_operation_logs(client, index, operation_id, query=None, level=None, since=None, until=None, limit=100, cursor=None, application=None):
+def get_operation_logs(client, index, operation_id, query=None, level=None, since=None, until=None, limit=100, cursor=None, application=None, component=None):
 	"""Get logs for an operation in chronological order."""
 	return search_logs_page(
 		client=client,
@@ -231,10 +238,11 @@ def get_operation_logs(client, index, operation_id, query=None, level=None, sinc
 		cursor=cursor,
 		sort_order="asc",
 		application=application,
+		component=component,
 	)
 
 
-def tail_logs(client, index, query=None, operation_id=None, area=None, level=None, since=None, until=None, limit=20, search_after=None, application=None):
+def tail_logs(client, index, query=None, operation_id=None, area=None, level=None, since=None, until=None, limit=20, search_after=None, application=None, component=None):
 	"""Tail log entries for an operation.
 
 	First call returns the most recent entries (newest first) and reverses for chronological display.
@@ -249,6 +257,7 @@ def tail_logs(client, index, query=None, operation_id=None, area=None, level=Non
 			since=since,
 			until=until,
 			application=application,
+			component=component,
 		),
 		"size": limit,
 	}
@@ -281,9 +290,11 @@ def tail_logs(client, index, query=None, operation_id=None, area=None, level=Non
 	return docs, next_search_after
 
 
-def get_operation_summary(client, index, operation_id, application=None):
+def get_operation_summary(client, index, operation_id, application=None, component=None):
 	"""Get summary for an operation using aggregations."""
 	op_query_filters = [{"term": {"operation_id": operation_id}}]
+	if component:
+		op_query_filters.append({"term": {"component": component}})
 	if application:
 		op_query_filters.append({"term": {"application": application}})
 	body = {
@@ -358,11 +369,13 @@ def get_operation_summary(client, index, operation_id, application=None):
 	}
 
 
-def list_operations(client, index, area=None, since=None, limit=20, with_errors_only=False, application=None):
+def list_operations(client, index, area=None, since=None, limit=20, with_errors_only=False, application=None, component=None):
 	"""List recent operations with summary stats."""
 	query_filters = []
 	if application:
 		query_filters.append({"term": {"application": application}})
+	if component:
+		query_filters.append({"term": {"component": component}})
 	if area:
 		query_filters.append({"term": {"area": area}})
 	if since:
@@ -434,9 +447,9 @@ def list_operations(client, index, area=None, since=None, limit=20, with_errors_
 	return operations
 
 
-def list_recent_operations(client, index, area=None, since=None, until=None, limit=20, order_by: str = "last_activity", with_errors_only: bool = False, application=None):
+def list_recent_operations(client, index, area=None, since=None, until=None, limit=20, order_by: str = "last_activity", with_errors_only: bool = False, application=None, component=None):
 	"""List recent operations ordered by last activity or error count."""
-	base_query = _build_log_query(area=area, since=since, until=until, application=application)
+	base_query = _build_log_query(area=area, since=since, until=until, application=application, component=component)
 	if order_by not in ("last_activity", "error_count"):
 		order_by = "last_activity"
 
@@ -551,13 +564,14 @@ def list_error_signatures(
 	min_count: int = 1,
 	include_missing: bool = False,
 	application=None,
+	component=None,
 ):
 	"""Aggregate error signatures by exception/message."""
 	if not field:
 		field = "exception"
 	field_name = field if field.endswith(".keyword") else f"{field}.keyword"
 
-	base_query = _build_log_query(area=area, since=since, until=until, application=application)
+	base_query = _build_log_query(area=area, since=since, until=until, application=application, component=component)
 	base_filters = base_query.get("bool", {}).get("filter", [])
 	base_filters.append({"terms": {"level": ["error", "critical"]}})
 	if not include_missing:
@@ -623,6 +637,7 @@ def get_error_context(
 	before: int = 20,
 	after: int = 20,
 	application=None,
+	component=None,
 ):
 	"""Fetch logs around an anchor timestamp."""
 	before_count = max(int(before or 0), 0)
@@ -641,6 +656,7 @@ def get_error_context(
 		sort_order="desc",
 		until_inclusive=True,
 		application=application,
+		component=component,
 	)
 	after_docs, _ = search_logs_page(
 		client=client,
@@ -654,17 +670,20 @@ def get_error_context(
 		sort_order="asc",
 		since_inclusive=False,
 		application=application,
+		component=component,
 	)
 	before_docs = list(reversed(before_docs))
 
 	return before_docs + after_docs
 
 
-def list_areas(client, index, since=None, min_operations=1, application=None):
+def list_areas(client, index, since=None, min_operations=1, application=None, component=None):
 	"""List all application areas with activity counts."""
 	query_filters = []
 	if application:
 		query_filters.append({"term": {"application": application}})
+	if component:
+		query_filters.append({"term": {"component": component}})
 	if since:
 		normalized_since = resolve_relative_time(since)
 		query_filters.append({"range": {"timestamp": {"gte": normalized_since}}})

{devlogs-2.2.0 → devlogs-2.2.2}/src/devlogs/web/server.py

@@ -34,11 +34,12 @@ def _try_client() -> Tuple[Optional[object], Optional[str]]:
 
 
 @app.get("/api/search")
-def search(q: Optional[str] = None, area: Optional[str] = None, level: Optional[str] = None, operation_id: Optional[str] = None, since: Optional[str] = None, limit: int = 50):
+def search(q: Optional[str] = None, area: Optional[str] = None, component: Optional[str] = None, level: Optional[str] = None, operation_id: Optional[str] = None, since: Optional[str] = None, application: Optional[str] = None, limit: int = 50):
 	client, error = _try_client()
 	if not client:
 		return {"results": [], "error": error}
 	cfg = load_config()
+	effective_application = application or cfg.application
 	docs = search_logs(
 		client,
 		cfg.index,
@@ -48,16 +49,19 @@ def search(q: Optional[str] = None, area: Optional[str] = None, level: Optional[
 		level=level,
 		since=since,
 		limit=limit,
+		application=effective_application,
+		component=component,
 	)
 	results = normalize_log_entries(docs, limit=limit)
 	return {"results": results}
 
 @app.get("/api/tail")
-def tail(operation_id: Optional[str] = None, area: Optional[str] = None, level: Optional[str] = None, since: Optional[str] = None, limit: int = 20):
+def tail(operation_id: Optional[str] = None, area: Optional[str] = None, component: Optional[str] = None, level: Optional[str] = None, since: Optional[str] = None, application: Optional[str] = None, limit: int = 20):
 	client, error = _try_client()
 	if not client:
 		return {"results": [], "error": error}
 	cfg = load_config()
+	effective_application = application or cfg.application
 	docs, cursor = tail_logs(
 		client,
 		cfg.index,
@@ -66,6 +70,8 @@ def tail(operation_id: Optional[str] = None, area: Optional[str] = None, level:
 		level=level,
 		since=since,
 		limit=limit,
+		application=effective_application,
+		component=component,
 	)
 	results = normalize_log_entries(docs, limit=limit)
 	return {"results": results, "cursor": cursor}

{devlogs-2.2.0 → devlogs-2.2.2}/src/devlogs/web/static/devlogs.js

@@ -2,6 +2,7 @@
 const elements = {
 	search: document.getElementById('search'),
 	area: document.getElementById('area'),
+	component: document.getElementById('component'),
 	operation: document.getElementById('operation'),
 	level: document.getElementById('level'),
 	limit: document.getElementById('limit'),
@@ -240,6 +241,7 @@ async function fetchLogs({ append = false } = {}) {
 	const query = elements.search.value.trim();
 	if (query) params.set('q', query);
 	if (elements.area.value.trim()) params.set('area', elements.area.value.trim());
+	if (elements.component.value.trim()) params.set('component', elements.component.value.trim());
 	if (elements.operation.value.trim()) params.set('operation_id', elements.operation.value.trim());
 	if (elements.level.value) params.set('level', elements.level.value);
 	if (elements.limit.value) params.set('limit', elements.limit.value);
@@ -322,6 +324,7 @@ function setFollow(enabled) {
 
 elements.search.addEventListener('input', () => fetchLogs());
 elements.area.addEventListener('input', () => fetchLogs());
+elements.component.addEventListener('input', () => fetchLogs());
 elements.operation.addEventListener('input', () => fetchLogs());
 elements.level.addEventListener('change', () => fetchLogs());
 elements.limit.addEventListener('change', () => fetchLogs());

{devlogs-2.2.0 → devlogs-2.2.2}/src/devlogs/web/static/index.html

@@ -23,6 +23,10 @@
 						<label for="area">Area</label>
 						<input id="area" placeholder="web, jobs" />
 					</div>
+					<div class="field">
+						<label for="component">Component</label>
+						<input id="component" placeholder="worker, api" />
+					</div>
 					<div class="field">
 						<label for="operation">Operation</label>
 						<input id="operation" placeholder="operation id" />

{devlogs-2.2.0 → devlogs-2.2.2/src/devlogs.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devlogs
-Version: 2.2.0
+Version: 2.2.2
 Summary: Developer-focused logging library for Python with OpenSearch integration.
 Author-email: Dan Driscoll <dan@thedandriscoll.org>
 License: MIT License

{devlogs-2.2.0 → devlogs-2.2.2}/tests/test_web.py

@@ -9,7 +9,7 @@ from devlogs.web import server
 
 def _set_client_ready(monkeypatch, index_name="devlogs-test"):
 	monkeypatch.setattr(server, "_try_client", lambda: (object(), None))
-	monkeypatch.setattr(server, "load_config", lambda: SimpleNamespace(index=index_name))
+	monkeypatch.setattr(server, "load_config", lambda: SimpleNamespace(index=index_name, application=None))
 
 def test_search_endpoint(monkeypatch):
 	_set_client_ready(monkeypatch)

devlogs-2.2.0/src/devlogs/formatting.py

@@ -1,34 +0,0 @@
-# Formatting utilities for devlogs output
-
-from datetime import datetime, timezone
-
-
-def format_timestamp(timestamp_str: str | None, use_utc: bool = False) -> str:
-	"""
-	Format a timestamp string for display.
-	
-	Args:
-		timestamp_str: ISO 8601 timestamp string (typically UTC with Z suffix) or None
-		use_utc: If True, display in UTC; if False, display in local time
-	
-	Returns:
-		Formatted timestamp string
-	"""
-	if not timestamp_str:
-		return ""
-	
-	try:
-		# Parse the ISO timestamp (handles Z suffix and +00:00 format)
-		dt = datetime.fromisoformat(timestamp_str.replace("Z", "+00:00"))
-		
-		if use_utc:
-			# Keep in UTC, format as ISO-like string
-			dt_utc = dt.astimezone(timezone.utc)
-			return dt_utc.strftime("%Y-%m-%dT%H:%M:%S.%f")[:-3] + "Z"
-		else:
-			# Convert to local time
-			dt_local = dt.astimezone()
-			return dt_local.strftime("%Y-%m-%dT%H:%M:%S.%f")[:-3]
-	except (ValueError, AttributeError):
-		# If parsing fails, return original string
-		return timestamp_str