Skip to main content

Exploration

Resource Exploration in pulumi-logtail.
6 min read

Resource Exploration in pulumi-logtail.

Pulumi type: logtail:index/exploration:Exploration.

name is the Pulumi resource name. Nested object fields are documented under that object. They are not arguments of this resource.

Example#

Only required arguments are set. A string in angle brackets stands in for that argument. Any other value is an option or example written in the SDK description.

Arguments#

PropertyTypeRequiredDescription
chartExplorationChart (input)yesThe chart configuration for this exploration.
dateRangeFromstringnoThe start of the date range (e.g., 'now-3h', 'now-24h').
dateRangeTostringnoThe end of the date range (e.g., 'now').
explorationGroupIdnumbernoThe ID of the exploration group this exploration belongs to. Use 0 to remove from group.
namestringnoThe name of this exploration.
queriesExplorationQuery (input)[]yesThe queries for this exploration. At least one query is required.
teamNamestringnoUsed to specify the team the resource should be created in when using global tokens. You can't update this value later.
variablesExplorationVariable (input)[]noVariables for this exploration. Default variables (time, start_time, end_time, source) are auto-created.

Outputs#

Computed outputs are produced by the provider. They are not constructor arguments.

PropertyTypeComputedDescription
chartExplorationChart (output)noThe chart configuration for this exploration.
createdAtstringyesThe time when this exploration was created.
dateRangeFromstringnoThe start of the date range (e.g., 'now-3h', 'now-24h').
dateRangeTostringnoThe end of the date range (e.g., 'now').
explorationGroupIdnumbernoThe ID of the exploration group this exploration belongs to. Use 0 to remove from group.
namestringnoThe name of this exploration.
queriesExplorationQuery (output)[]noThe queries for this exploration. At least one query is required.
teamNamestringnoUsed to specify the team the resource should be created in when using global tokens. You can't update this value later.
updatedAtstringyesThe time when this exploration was updated.
variablesExplorationVariable (output)[]noVariables for this exploration. Default variables (time, start_time, end_time, source) are auto-created.

ExplorationChart (input)#

Input object ExplorationChart. Fields below belong to this object, not to the parent.

PropertyTypeRequiredDescription
chartTypestringyesThe type of chart: 'line_chart', 'bar_chart', 'pie_chart', 'number_chart', 'table_chart', 'tail_chart', 'static_text_chart', 'scatter_chart', 'gauge_chart', 'heatmap_chart', 'map_chart', 'text_chart', 'funnel_chart', or 'anomalies_chart'.
descriptionstringnoThe description of the chart.
namestringnoThe name of the chart. Automatically set to the exploration name by the API.
settingsstringnoChart settings as a JSON string. Settings vary by chart type and include options like unit, decimal_places, legend, stacking, etc.

ExplorationQuery (input)#

Input object ExplorationQuery. Fields below belong to this object, not to the parent.

PropertyTypeRequiredDescription
idnumbernoThe ID of this query (read-only).
namestringnoThe name of the query.
queryTypestringyesThe type of query: 'sql_expression', 'tail_query', or 'static_text'. Note: 'pql_expression', 'query_builder', and 'funnel_query' are read-only.
sourceVariablestringnoThe source variable reference (default: 'source').
sqlQuerystringnoThe SQL query string. Required when queryType is 'sql_expression'.
staticTextstringnoThe static text content (markdown). Required when queryType is 'static_text'.
whereConditionstringnoThe WHERE condition for filtering. Required when queryType is 'tail_query'.

ExplorationVariable (input)#

Input object ExplorationVariable. Fields below belong to this object, not to the parent.

PropertyTypeRequiredDescription
defaultValuesstring[]noFor 'string', 'number', and 'boolean' variables: fallback value used when values is empty. For 'select_value' variables: the predefined options shown in the picker. Unused for other types.
namestringyesThe name of the variable (used as {{name}} in queries).
sqlDefinitionstringnoSQL definition for 'select_with_sql' or 'multi_select_with_sql' type variables.
valuesstring[]noThe selected values. For 'source' variables these are the source IDs the variable resolves to (e.g. logtail_source.web.id) - this is the field that selects the source. For other types it is the current picker selection or input.
variableTypestringyesThe type of variable: 'source', 'string', 'number', 'date', 'datetime', 'boolean', 'sql_expression', 'select_value', 'select_with_sql', or 'multi_select_with_sql'.

ExplorationChart (output)#

Output object ExplorationChart. Fields below belong to this object.

PropertyTypeAlways presentDescription
chartTypestringyesThe type of chart: 'line_chart', 'bar_chart', 'pie_chart', 'number_chart', 'table_chart', 'tail_chart', 'static_text_chart', 'scatter_chart', 'gauge_chart', 'heatmap_chart', 'map_chart', 'text_chart', 'funnel_chart', or 'anomalies_chart'.
descriptionstringyesThe description of the chart.
namestringyesThe name of the chart. Automatically set to the exploration name by the API.
settingsstringyesChart settings as a JSON string. Settings vary by chart type and include options like unit, decimal_places, legend, stacking, etc.

ExplorationQuery (output)#

Output object ExplorationQuery. Fields below belong to this object.

PropertyTypeAlways presentDescription
idnumberyesThe ID of this query (read-only).
namestringnoThe name of the query.
queryTypestringyesThe type of query: 'sql_expression', 'tail_query', or 'static_text'. Note: 'pql_expression', 'query_builder', and 'funnel_query' are read-only.
sourceVariablestringyesThe source variable reference (default: 'source').
sqlQuerystringnoThe SQL query string. Required when queryType is 'sql_expression'.
staticTextstringnoThe static text content (markdown). Required when queryType is 'static_text'.
whereConditionstringnoThe WHERE condition for filtering. Required when queryType is 'tail_query'.

ExplorationVariable (output)#

Output object ExplorationVariable. Fields below belong to this object.

PropertyTypeAlways presentDescription
defaultValuesstring[]noFor 'string', 'number', and 'boolean' variables: fallback value used when values is empty. For 'select_value' variables: the predefined options shown in the picker. Unused for other types.
namestringyesThe name of the variable (used as {{name}} in queries).
sqlDefinitionstringnoSQL definition for 'select_with_sql' or 'multi_select_with_sql' type variables.
valuesstring[]noThe selected values. For 'source' variables these are the source IDs the variable resolves to (e.g. logtail_source.web.id) - this is the field that selects the source. For other types it is the current picker selection or input.
variableTypestringyesThe type of variable: 'source', 'string', 'number', 'date', 'datetime', 'boolean', 'sql_expression', 'select_value', 'select_with_sql', or 'multi_select_with_sql'.