"""Fastn AWS Cloudwatch connector — auto-generated type stubs.

Do not edit manually. Regenerate with `fastn connector sync`.
"""
from __future__ import annotations

from typing import Any, Dict, List, Optional, TypedDict


class AwsCloudwatchConnector:
    """AWS Cloudwatch connector ().

    Provides 1 tools.
    """

    def aws_cloudwatch_execute_query(
        self,
        endTime: Optional[str] = None,
        limit: Optional[int] = None,
        logGroupName: Optional[str] = None,
        queryString: Optional[str] = None,
        startTime: Optional[str] = None,
    ) -> Dict[str, Any]:
        """Executes a CloudWatch Logs Insights query against one or more CloudWatch log groups to retrieve and analyze log data. Use this tool when you need to run structured queries over CloudWatch logs to diagnose application issues, extract metrics from logs, or investigate system behavior. Do not use this tool for querying CloudWatch metrics (time-series data); use CloudWatch Metrics APIs for that purpose. Note: query execution may take time to complete depending on log volume.

        Args:
            endTime: End time for the log query (e.g., ISO8601 format).
            limit: Maximum number of log events to return.
            logGroupName: Name of the Cloudwatch log group to query.
            queryString: Filter logs based on a provided query string (CloudWatch Insights).
            startTime: Start time for the log query (e.g., ISO8601 format).
        Returns:
            API response as a dictionary.
        """
        ...

