FAQ

Q: How do I start sending data to IyziTrace?

A: IyziTrace doesn't collect data directly. Configure your applications to send:

• Traces to Tempo (via OTLP)
• Logs to Loki
• Metrics to Prometheus

Then connect these datasources in IyziTrace settings.

Q: Why don't I see my services?

A: Ensure:

1. Your datasources are connected.
2. Data is being sent to Prometheus/Tempo/Loki.
3. Metrics contain required labels (service_name, etc.).
4. Definitions in Settings match your label names.

Q: How do I map orphan services?

A: Drag the service from "Orphan Services" section and drop it on the target infrastructure card.

Q: Can I use IyziTrace without AI features?

A: Yes! AI Assistant is optional. All core features work without it.

Q: How are permissions enforced?

A: Permissions are enforced through team-based access control. Admins see everything; team users see only assigned pages.

Q: Can I export my data?

A: Yes:

• Tables support CSV export
• Traces can be exported as JSON
• Use the datasource APIs to fetch raw data

Q: How do I troubleshoot missing infrastructure?

A: Check that:

1. Prometheus is scraping __inv_base metric.
2. Host inventory is being collected.
3. Required labels (host_name, cloud_region) are present.

Q: What OpenTelemetry version is supported?

A: IyziTrace supports OpenTelemetry 1.0+ and is compatible with OTLP protocol.

Q: Can I customize metric definitions?

A: Yes! Go to Settings → Definitions to add custom metric patterns.

Q: How do I configure alerts?

A: Alerts are managed through Grafana's native alerting system. Create alert rules based on your datasources.