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