> ## Documentation Index
> Fetch the complete documentation index at: https://docs.synehq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SyneHQ x Elasticsearch Integration

> Learn how to use Elasticsearch seamlessly within SyneHQ—setup, features, advanced queries, and troubleshooting.

<Info>
  <b>New Release!</b> SyneHQ natively integrates with Elasticsearch—run complex queries, analyze logs, and visualize data in real-time.
</Info>

* <b>Native Elasticsearch container support:</b> Connect instantly to your clusters—on-prem or cloud.
* <b>Cloud deployment integration:</b> Works across AWS, GCP, Azure, etc.
* <b>Real-time chat interface:</b> Ask questions about your data—no SQL required.
* <b>Seamless query execution:</b> Just type a prompt, see instant results or visualizations.
* <b>Role-based dashboards:</b> Custom views for SREs, Data Analysts, and App Engineers.

<video controls src="https://video.twimg.com/amplify_video/1943716456924876800/vid/avc1/1280x720/CRLZ_oo13HR8NPNC.mp4?tag=14" />

## 🏁 Getting Started

<Accordion title="Integration Prerequisites">
  * You need an active SyneHQ account with Admin access.
  * An Elasticsearch instance (7.x or higher recommended), cloud or self-hosted.
  * API endpoint URL & credentials for Elasticsearch.
</Accordion>

### Step-by-Step Setup

1. In SyneHQ, go to `Integrations → Add Data Source`
2. Select <b>Elasticsearch</b> from the list.
3. Enter:
   * Cluster URL
   * API Key or Basic Auth credentials
   * (Optional) Index pattern(s)
4. Click <b>Test Connection</b>. If successful, click <b>Connect</b>.
5. SyneHQ auto-indexes your schemas—query instantly!

## 💡 Example Natural Language Queries

1. `Show me all error logs from the last hour`
2. `Find users with high transaction volumes`
3. `Analyze API response times by endpoint over the past day`
4. `Search for security anomalies in user behavior`
5. `List unique browsers used by admin users this week`

## 📊 Advanced Features

<Accordion title="Analytics & Visualization">
  * Automatic chart suggestions based on your query
  * Compare metrics (e.g., avg. response time by endpoint)
  * Drill-down capabilities for multi-dimensional analytics
</Accordion>

<Accordion title="Real-Time Collaboration & Alerts">
  * Share queries and dashboards with your team
  * Schedule jobs to monitor error spikes and KPI changes
  * Receive Slack/Email alerts on anomalies or thresholds
</Accordion>

## 📝 Demo Video: Walkthrough

<Accordion title="What's inside the video?">
  * See the setup and core workflow, including:
    * Code editor with prompt-to-query interface
    * Live dashboards for error log analysis & more
    * How to use conversational search with complex filters
</Accordion>

## 🦾 Pro Tips

<Accordion title="Best Practices">
  * Use index wildcards (e.g., <code>log-\*</code>) for broad search
  * Stack queries for custom dashboards (response time, error count)
  * Secure your data—use API Keys with granular perms
  * Leverage saved query templates for recurring reports
</Accordion>

## 🛟 Troubleshooting

<Accordion title="If you see 'Connection Failed'...">
  * Check that your Elasticsearch instance is reachable and not firewalled.
  * Re-verify your API Key/credentials.
  * Ensure index patterns are correct.
</Accordion>

***

<Info variant="note">
  Need more help? Ping <b>@theboringhumane</b> on X, or join the <b>SyneHQ Community Slack</b> for support and feature requests.
</Info>