Skip to content

InfluxDBv2Parameters

Source code in docs_src/capo_timestream_influxdb/types/influx_d_bv2_parameters.py
class InfluxDBv2Parameters(TypedDict, closed=True):
    flux_log_enabled: NotRequired["bool"]
    """<p>Include option to show detailed logs for Flux queries.</p> <p>Default: false</p>"""
    log_level: NotRequired["capo_timestream_influxdb.types.log_level.LogLevel"]
    """<p>Log output level. InfluxDB outputs log entries with severity levels greater than or equal to the level specified.</p> <p>Default: info</p>"""
    no_tasks: NotRequired["bool"]
    """<p>Disable the task scheduler. If problematic tasks prevent InfluxDB from starting, use this option to start InfluxDB without scheduling or executing tasks.</p> <p>Default: false</p>"""
    query_concurrency: NotRequired["int"]
    """<p>Number of queries allowed to execute concurrently. Setting to 0 allows an unlimited number of concurrent queries.</p> <p>Default: 0</p>"""
    query_queue_size: NotRequired["int"]
    """<p>Maximum number of queries allowed in execution queue. When queue limit is reached, new queries are rejected. Setting to 0 allows an unlimited number of queries in the queue.</p> <p>Default: 0</p>"""
    tracing_type: NotRequired["capo_timestream_influxdb.types.tracing_type.TracingType"]
    """<p>Enable tracing in InfluxDB and specifies the tracing type. Tracing is disabled by default.</p>"""
    metrics_disabled: NotRequired["bool"]
    """<p>Disable the HTTP /metrics endpoint which exposes <a href="https://docs.influxdata.com/influxdb/v2/reference/internals/metrics/">internal InfluxDB metrics</a>.</p> <p>Default: false</p>"""
    http_idle_timeout: NotRequired["capo_timestream_influxdb.types.duration.Duration"]
    """<p>Maximum duration the server should keep established connections alive while waiting for new requests. Set to 0 for no timeout.</p> <p>Default: 3 minutes</p>"""
    http_read_header_timeout: NotRequired[
        "capo_timestream_influxdb.types.duration.Duration"
    ]
    """<p>Maximum duration the server should try to read HTTP headers for new requests. Set to 0 for no timeout.</p> <p>Default: 10 seconds</p>"""
    http_read_timeout: NotRequired["capo_timestream_influxdb.types.duration.Duration"]
    """<p>Maximum duration the server should try to read the entirety of new requests. Set to 0 for no timeout.</p> <p>Default: 0</p>"""
    http_write_timeout: NotRequired["capo_timestream_influxdb.types.duration.Duration"]
    """<p>Maximum duration the server should spend processing and responding to write requests. Set to 0 for no timeout.</p> <p>Default: 0</p>"""
    influxql_max_select_buckets: NotRequired["int"]
    """<p>Maximum number of group by time buckets a SELECT statement can create. 0 allows an unlimited number of buckets.</p> <p>Default: 0</p>"""
    influxql_max_select_point: NotRequired["int"]
    """<p>Maximum number of points a SELECT statement can process. 0 allows an unlimited number of points. InfluxDB checks the point count every second (so queries exceeding the maximum aren’t immediately aborted).</p> <p>Default: 0</p>"""
    influxql_max_select_series: NotRequired["int"]
    """<p>Maximum number of series a SELECT statement can return. 0 allows an unlimited number of series.</p> <p>Default: 0</p>"""
    pprof_disabled: NotRequired["bool"]
    """<p>Disable the /debug/pprof HTTP endpoint. This endpoint provides runtime profiling data and can be helpful when debugging.</p> <p>Default: true</p>"""
    query_initial_memory_bytes: NotRequired["int"]
    """<p>Initial bytes of memory allocated for a query.</p> <p>Default: 0</p>"""
    query_max_memory_bytes: NotRequired["int"]
    """<p>Maximum total bytes of memory allowed for all running queries. When this limit is reached, new queries are rejected. Setting to 0 allows unlimited memory usage.</p> <p>Default: 0</p>"""
    query_memory_bytes: NotRequired["int"]
    """<p>Maximum bytes of memory allowed for a single query. Must be greater or equal to queryInitialMemoryBytes.</p> <p>Default: 0</p>"""
    session_length: NotRequired["int"]
    """<p>Specifies the Time to Live (TTL) in minutes for newly created user sessions.</p> <p>Default: 60</p>"""
    session_renew_disabled: NotRequired["bool"]
    """<p>Disables automatically extending a user’s session TTL on each request. By default, every request sets the session’s expiration time to five minutes from now. When disabled, sessions expire after the specified <a href="https://docs.influxdata.com/influxdb/v2/reference/config-options/#session-length">session length</a> and the user is redirected to the login page, even if recently active.</p> <p>Default: false</p>"""
    storage_cache_max_memory_size: NotRequired["int"]
    """<p>Maximum size (in bytes) a shard’s cache can reach before it starts rejecting writes. Must be greater than storageCacheSnapShotMemorySize and lower than instance’s total memory capacity. We recommend setting it to below 15% of the total memory capacity.</p> <p>Default: 1073741824</p>"""
    storage_cache_snapshot_memory_size: NotRequired["int"]
    """<p>Size (in bytes) at which the storage engine will snapshot the cache and write it to a TSM file to make more memory available. Must not be greater than storageCacheMaxMemorySize.</p> <p>Default: 26214400</p>"""
    storage_cache_snapshot_write_cold_duration: NotRequired[
        "capo_timestream_influxdb.types.duration.Duration"
    ]
    """<p>Duration at which the storage engine will snapshot the cache and write it to a new TSM file if the shard hasn’t received writes or deletes.</p> <p>Default: 10 minutes</p>"""
    storage_compact_full_write_cold_duration: NotRequired[
        "capo_timestream_influxdb.types.duration.Duration"
    ]
    """<p>Duration at which the storage engine will compact all TSM files in a shard if it hasn't received writes or deletes.</p> <p>Default: 4 hours</p>"""
    storage_compact_throughput_burst: NotRequired["int"]
    """<p>Rate limit (in bytes per second) that TSM compactions can write to disk.</p> <p>Default: 50331648</p>"""
    storage_max_concurrent_compactions: NotRequired["int"]
    """<p>Maximum number of full and level compactions that can run concurrently. A value of 0 results in 50% of runtime.GOMAXPROCS(0) used at runtime. Any number greater than zero limits compactions to that value. This setting does not apply to cache snapshotting.</p> <p>Default: 0</p>"""
    storage_max_index_log_file_size: NotRequired["int"]
    """<p>Size (in bytes) at which an index write-ahead log (WAL) file will compact into an index file. Lower sizes will cause log files to be compacted more quickly and result in lower heap usage at the expense of write throughput.</p> <p>Default: 1048576</p>"""
    storage_no_validate_field_size: NotRequired["bool"]
    """<p>Skip field size validation on incoming write requests.</p> <p>Default: false</p>"""
    storage_retention_check_interval: NotRequired[
        "capo_timestream_influxdb.types.duration.Duration"
    ]
    """<p>Interval of retention policy enforcement checks. Must be greater than 0.</p> <p>Default: 30 minutes</p>"""
    storage_series_file_max_concurrent_snapshot_compactions: NotRequired["int"]
    """<p>Maximum number of snapshot compactions that can run concurrently across all series partitions in a database.</p> <p>Default: 0</p>"""
    storage_series_id_set_cache_size: NotRequired["int"]
    """<p>Size of the internal cache used in the TSI index to store previously calculated series results. Cached results are returned quickly rather than needing to be recalculated when a subsequent query with the same tag key/value predicate is executed. Setting this value to 0 will disable the cache and may decrease query performance.</p> <p>Default: 100</p>"""
    storage_wal_max_concurrent_writes: NotRequired["int"]
    """<p>Maximum number writes to the WAL directory to attempt at the same time. Setting this value to 0 results in number of processing units available x2.</p> <p>Default: 0</p>"""
    storage_wal_max_write_delay: NotRequired[
        "capo_timestream_influxdb.types.duration.Duration"
    ]
    """<p>Maximum amount of time a write request to the WAL directory will wait when the <a href="https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-wal-max-concurrent-writes">maximum number of concurrent active writes to the WAL directory has been met</a>. Set to 0 to disable the timeout.</p> <p>Default: 10 minutes</p>"""
    ui_disabled: NotRequired["bool"]
    """<p>Disable the InfluxDB user interface (UI). The UI is enabled by default.</p> <p>Default: false</p>"""

flux_log_enabled instance-attribute

flux_log_enabled: NotRequired[bool]

Include option to show detailed logs for Flux queries.

Default: false

http_idle_timeout instance-attribute

http_idle_timeout: NotRequired[Duration]

Maximum duration the server should keep established connections alive while waiting for new requests. Set to 0 for no timeout.

Default: 3 minutes

http_read_header_timeout instance-attribute

http_read_header_timeout: NotRequired[Duration]

Maximum duration the server should try to read HTTP headers for new requests. Set to 0 for no timeout.

Default: 10 seconds

http_read_timeout instance-attribute

http_read_timeout: NotRequired[Duration]

Maximum duration the server should try to read the entirety of new requests. Set to 0 for no timeout.

Default: 0

http_write_timeout instance-attribute

http_write_timeout: NotRequired[Duration]

Maximum duration the server should spend processing and responding to write requests. Set to 0 for no timeout.

Default: 0

influxql_max_select_buckets instance-attribute

influxql_max_select_buckets: NotRequired[int]

Maximum number of group by time buckets a SELECT statement can create. 0 allows an unlimited number of buckets.

Default: 0

influxql_max_select_point instance-attribute

influxql_max_select_point: NotRequired[int]

Maximum number of points a SELECT statement can process. 0 allows an unlimited number of points. InfluxDB checks the point count every second (so queries exceeding the maximum aren’t immediately aborted).

Default: 0

influxql_max_select_series instance-attribute

influxql_max_select_series: NotRequired[int]

Maximum number of series a SELECT statement can return. 0 allows an unlimited number of series.

Default: 0

log_level instance-attribute

log_level: NotRequired[LogLevel]

Log output level. InfluxDB outputs log entries with severity levels greater than or equal to the level specified.

Default: info

metrics_disabled instance-attribute

metrics_disabled: NotRequired[bool]

Disable the HTTP /metrics endpoint which exposes internal InfluxDB metrics.

Default: false

no_tasks instance-attribute

no_tasks: NotRequired[bool]

Disable the task scheduler. If problematic tasks prevent InfluxDB from starting, use this option to start InfluxDB without scheduling or executing tasks.

Default: false

pprof_disabled instance-attribute

pprof_disabled: NotRequired[bool]

Disable the /debug/pprof HTTP endpoint. This endpoint provides runtime profiling data and can be helpful when debugging.

Default: true

query_concurrency instance-attribute

query_concurrency: NotRequired[int]

Number of queries allowed to execute concurrently. Setting to 0 allows an unlimited number of concurrent queries.

Default: 0

query_initial_memory_bytes instance-attribute

query_initial_memory_bytes: NotRequired[int]

Initial bytes of memory allocated for a query.

Default: 0

query_max_memory_bytes instance-attribute

query_max_memory_bytes: NotRequired[int]

Maximum total bytes of memory allowed for all running queries. When this limit is reached, new queries are rejected. Setting to 0 allows unlimited memory usage.

Default: 0

query_memory_bytes instance-attribute

query_memory_bytes: NotRequired[int]

Maximum bytes of memory allowed for a single query. Must be greater or equal to queryInitialMemoryBytes.

Default: 0

query_queue_size instance-attribute

query_queue_size: NotRequired[int]

Maximum number of queries allowed in execution queue. When queue limit is reached, new queries are rejected. Setting to 0 allows an unlimited number of queries in the queue.

Default: 0

session_length instance-attribute

session_length: NotRequired[int]

Specifies the Time to Live (TTL) in minutes for newly created user sessions.

Default: 60

session_renew_disabled instance-attribute

session_renew_disabled: NotRequired[bool]

Disables automatically extending a user’s session TTL on each request. By default, every request sets the session’s expiration time to five minutes from now. When disabled, sessions expire after the specified session length and the user is redirected to the login page, even if recently active.

Default: false

storage_cache_max_memory_size instance-attribute

storage_cache_max_memory_size: NotRequired[int]

Maximum size (in bytes) a shard’s cache can reach before it starts rejecting writes. Must be greater than storageCacheSnapShotMemorySize and lower than instance’s total memory capacity. We recommend setting it to below 15% of the total memory capacity.

Default: 1073741824

storage_cache_snapshot_memory_size instance-attribute

storage_cache_snapshot_memory_size: NotRequired[int]

Size (in bytes) at which the storage engine will snapshot the cache and write it to a TSM file to make more memory available. Must not be greater than storageCacheMaxMemorySize.

Default: 26214400

storage_cache_snapshot_write_cold_duration instance-attribute

storage_cache_snapshot_write_cold_duration: NotRequired[Duration]

Duration at which the storage engine will snapshot the cache and write it to a new TSM file if the shard hasn’t received writes or deletes.

Default: 10 minutes

storage_compact_full_write_cold_duration instance-attribute

storage_compact_full_write_cold_duration: NotRequired[Duration]

Duration at which the storage engine will compact all TSM files in a shard if it hasn't received writes or deletes.

Default: 4 hours

storage_compact_throughput_burst instance-attribute

storage_compact_throughput_burst: NotRequired[int]

Rate limit (in bytes per second) that TSM compactions can write to disk.

Default: 50331648

storage_max_concurrent_compactions instance-attribute

storage_max_concurrent_compactions: NotRequired[int]

Maximum number of full and level compactions that can run concurrently. A value of 0 results in 50% of runtime.GOMAXPROCS(0) used at runtime. Any number greater than zero limits compactions to that value. This setting does not apply to cache snapshotting.

Default: 0

storage_max_index_log_file_size instance-attribute

storage_max_index_log_file_size: NotRequired[int]

Size (in bytes) at which an index write-ahead log (WAL) file will compact into an index file. Lower sizes will cause log files to be compacted more quickly and result in lower heap usage at the expense of write throughput.

Default: 1048576

storage_no_validate_field_size instance-attribute

storage_no_validate_field_size: NotRequired[bool]

Skip field size validation on incoming write requests.

Default: false

storage_retention_check_interval instance-attribute

storage_retention_check_interval: NotRequired[Duration]

Interval of retention policy enforcement checks. Must be greater than 0.

Default: 30 minutes

storage_series_file_max_concurrent_snapshot_compactions instance-attribute

storage_series_file_max_concurrent_snapshot_compactions: NotRequired[int]

Maximum number of snapshot compactions that can run concurrently across all series partitions in a database.

Default: 0

storage_series_id_set_cache_size instance-attribute

storage_series_id_set_cache_size: NotRequired[int]

Size of the internal cache used in the TSI index to store previously calculated series results. Cached results are returned quickly rather than needing to be recalculated when a subsequent query with the same tag key/value predicate is executed. Setting this value to 0 will disable the cache and may decrease query performance.

Default: 100

storage_wal_max_concurrent_writes instance-attribute

storage_wal_max_concurrent_writes: NotRequired[int]

Maximum number writes to the WAL directory to attempt at the same time. Setting this value to 0 results in number of processing units available x2.

Default: 0

storage_wal_max_write_delay instance-attribute

storage_wal_max_write_delay: NotRequired[Duration]

Maximum amount of time a write request to the WAL directory will wait when the maximum number of concurrent active writes to the WAL directory has been met. Set to 0 to disable the timeout.

Default: 10 minutes

tracing_type instance-attribute

tracing_type: NotRequired[TracingType]

Enable tracing in InfluxDB and specifies the tracing type. Tracing is disabled by default.

ui_disabled instance-attribute

ui_disabled: NotRequired[bool]

Disable the InfluxDB user interface (UI). The UI is enabled by default.

Default: false