Skip to Main Content
Cloud Management and AIOps

This is an IBM Automation portal for Cloud Management and AIOps products. To view all of your ideas submitted to IBM, create and manage groups of Ideas, or create an idea explicitly set to be either visible by all (public) or visible only to you and IBM (private), use the IBM Unified Ideas Portal (

Shape the future of IBM!

We invite you to shape the future of IBM, including product roadmaps, by submitting ideas that matter to you the most. Here's how it works:

Search existing ideas

Start by searching and reviewing ideas and requests to enhance a product or service. Take a look at ideas others have posted, and add a comment, vote, or subscribe to updates on them if they matter to you. If you can't find what you are looking for,

Post your ideas
  1. Post an idea.

  2. Get feedback from the IBM team and other customers to refine your idea.

  3. Follow the idea through the IBM Ideas process.

Specific links you will want to bookmark for future use

Welcome to the IBM Ideas Portal ( - Use this site to find out additional information and details about the IBM Ideas process and statuses.

IBM Unified Ideas Portal ( - Use this site to view all of your ideas, create new ideas for any IBM product, or search for ideas across all of IBM. - Use this email to suggest enhancements to the Ideas process or request help from IBM for submitting your Ideas.

Status Planned for future release
Workspace Instana
Created by Guest
Created on Jul 18, 2023

Instana API: Inclusion of Synthetic Trace Calls in Instana API Query for Analyze Trace

Dear IBM Instana Team,

Our team frequently utilizes the Instana API to retrieve in-depth alarming details by closely scrutinizing trace details. This has significantly aided our performance analysis and error identification efforts. However, we have encountered a challenge that we hope can be addressed.

We rely on synthetic trace calls related to health checks to obtain granular error details, but we've noticed that the current API does not provide a direct way to query these synthetic or health check-related trace calls. This absence is hindering our ability to thoroughly understand and resolve specific issues.

Reviewing the current API documentation available at, we have been unable to find a parameter that could facilitate such a query. We wonder if a parameter, such as 'includeSynthetics', could be integrated into the API for this purpose.

We have observed that similar parameters exist in other APIs, as demonstrated here: We believe the inclusion of such a feature in the Instana API would greatly enhance our analysis capabilities and we're hopeful that other users could also benefit from it.

We kindly request you to consider implementing this feature in the upcoming iterations of the Instana API. Your support in this matter would be greatly appreciated and would enable us to continue using Instana as an integral part of our monitoring and error management process.

Thank you for your time and attention to this matter.

Idea priority High
  • Admin
    Henning Treu
    Feb 21, 2024

    Hey Alireza,

    I'm sorry for the confusion, but it seems our API docs are missing some crucial fields for /api/application-monitoring/analyze/traces.

    In fact the top level elements available are:

    { "timeFrame": { }, "tagFilterExpression": { }, "metrics": [ ], "order": { }, "group": {}, "includeInternal": false, "includeSynthetic": true }

    This is also the output of the "API Query" button you would find in the Instana Analyse UI.

    We will update the API docs accordingly for the next release. I hope this solves it for you.

    2nd attempt to explain the matter and future plans:

    The /api/application-monitoring/analyze/traces operation actually does not support synthetic calls, yet. I will have this added in one of the following release, stay tuned for an update.

    The UI button for "Analyse Traces" is showing the wrong API operation and should in fact point to /api/application-monitoring/analyze/trace-groups, which has all the filter parameters available.


    Henning Treu - Instana Product Manager