The Hera Log Detail Query toolkit is a specialized Claude skill designed for programmatic log retrieval and analysis. It enables developers and SREs to efficiently query system logs using precise filters such as spaceId, storeId, and tailName, significantly accelerating the debugging process and system observability within the Hera ecosystem.

When should I use hera?

hera is useful in the following scenarios: • Rapid Debugging: Quickly isolate application errors by searching for specific keywords like 'Exception' or 'Timeout' within a defined time window. • Incident Response: Retrieve detailed log sequences from specific service tails to identify the root cause of system outages or performance degradation. • Log Auditing: Programmatically fetch and review logs across different environments (spaces and stores) to ensure operational compliance and system health. • Custom Time-Range Analysis: Analyze system behavior during specific historical events by querying logs with millisecond-precision timestamps.

name	hera
description	Hera log detail query toolkit for querying log details by spaceId, storeId, tailName and time range. Use this when you need to query Hera log information programmatically.

Hera Log Query Guide

Overview

This guide covers Hera log detail query operations using Python scripts. The skill provides functionality to query Hera log details with various filters including spaceId, storeId, input search terms, tailName, and time ranges.

Quick Start

import sys
sys.path.append('scripts')
from hera_log_detail_query import query_log_detail

# Query logs with basic parameters
result = query_log_detail(
    space_id=123,
    store_id=456,
    tail_name="test-tail-name"
)

# Query logs with all parameters
result = query_log_detail(
    space_id=123,
    store_id=456,
    tail_name="test-tail-name",
    input_text="error message",
    start_time="1638316800000",
    end_time="1638320400000"
)

Main Function

query_log_detail - Query Hera Log Details

Query Hera log details with filters.

Parameters:

space_id (int, required): Space ID
store_id (int, required): Store ID
tail_name (str, required): Tail name, e.g., "test-tail-name"
input_text (str, optional): Search input content, may contain special characters like quotes
start_time (str, optional): Query start time in milliseconds timestamp string. Defaults to 1 hour ago
end_time (str, optional): Query end time in milliseconds timestamp string. Defaults to current time
api_url (str, optional): API endpoint URL. Uses default from environment if not specified

Returns:

JSON response from Hera API containing log details

Example:

from hera_log_detail_query import query_log_detail

# Basic query
result = query_log_detail(
    space_id=123,
    store_id=456,
    tail_name="my-app-logs"
)

# Query with search term
result = query_log_detail(
    space_id=123,
    store_id=456,
    tail_name="my-app-logs",
    input_text="ERROR"
)

# Query with custom time range
import time
end_time = int(time.time() * 1000)
start_time = end_time - 3600000  # 1 hour ago

result = query_log_detail(
    space_id=123,
    store_id=456,
    tail_name="my-app-logs",
    start_time=str(start_time),
    end_time=str(end_time)
)

Common Tasks

Query Recent Logs

from hera_log_detail_query import query_log_detail

# Query logs from the last hour (default)
result = query_log_detail(
    space_id=123,
    store_id=456,
    tail_name="application-logs"
)

print(result)

Search for Specific Log Messages

from hera_log_detail_query import query_log_detail

# Search for error logs
result = query_log_detail(
    space_id=123,
    store_id=456,
    tail_name="application-logs",
    input_text="Exception"
)

print(result)

Query Logs in Custom Time Range

from hera_log_detail_query import query_log_detail
import time

# Query logs from 2 hours ago to 1 hour ago
current_time = int(time.time() * 1000)
end_time = str(current_time - 3600000)  # 1 hour ago
start_time = str(current_time - 7200000)  # 2 hours ago

result = query_log_detail(
    space_id=123,
    store_id=456,
    tail_name="application-logs",
    start_time=start_time,
    end_time=end_time
)

print(result)

Configuration

The default API URL is configured in the script. You can override it by:

Setting environment variable HERA_LOG_DETAIL_API_URL
Passing api_url parameter to the function

Error Handling

The script includes comprehensive error handling:

Parameter validation for required fields
HTTP request error handling
JSON parsing error handling
Detailed error messages for troubleshooting

Quick Reference

Task	Function	Required Parameters
Query recent logs	`query_log_detail()`	space_id, store_id, tail_name
Search logs	`query_log_detail()`	space_id, store_id, tail_name, input_text
Custom time range	`query_log_detail()`	space_id, store_id, tail_name, start_time, end_time

Next Steps

For detailed API documentation, see reference.md
For troubleshooting, check the error messages in the response

hera

When & Why to Use This Skill

Use Cases