Modal logo
Guide Introduction to Modal Getting started Functions Functions Invocation methods Function lookups Container lifecycle management Parametrized Functions Dynamic configuration Sandboxes Sandboxes Running commands Networking and security File access Snapshots Pricing and resources Sidecars BetaSecret injection BetaEndpoints Endpoints Shared Endpoints Dedicated Endpoints Endpoint candidates Endpoint integrations Training Quickstart Tinker-compatible API BetaMulti-node training Images Defining Images Using existing container images Named images Fast pull from registry GPUs and other resources GPU acceleration Using CUDA on Modal Configuring CPU, memory, and disk Scaling out Scaling out Input concurrency Batch processing Job queues Dynamic batching Multi-node Clusters Deployment Apps, Functions, and entrypoints Managing deployments Continuous deployment Scheduled Functions HTTP Applications Servers Sticky Sessions Web Functions Streaming endpoints Web Function URLs Request timeouts Proxy Tokens Networking Tunnels Proxies BetaCluster networking Data sharing and storage Passing local data Volumes Storing model weights Cloud bucket mounts Dicts Queues Dataset ingestion Secrets and environment variables Secrets Environment variables Performance Cold start performance Memory Snapshots High-performance LLM inference Reliability and robustness Failures and retries Preemption Timeouts GPU health Troubleshooting Security and privacy Security and privacy Data residency Customer-supplied encryption keys AlphaAudit logs Integrations Using OIDC to authenticate with external services Connecting Modal to your Datadog account Connecting Modal to your OpenTelemetry provider Okta SSO Microsoft Entra SSO Custom SAML SSO SCIM Integration Slack notifications BetaWorkspace & account settings Workspaces Environments Service users User groups Role-Based Access Control (RBAC) Billing Network egress billing Budgets Other topics Feature maturity Notebooks Restricted Functions JavaScript/Go SDKs BetaModal 1.0 migration guide File and project structure Developing and debugging Jupyter notebooks Asynchronous API usage Global variables Region selection GPU Metrics

Search syntax

Some search boxes in Modal accept a small query language, so you can filter by field instead of scanning raw output.

Filters 

A query is a list of filters separated by spaces. A filter is either a key:value pair or text to search for. Every filter has to match: they’re combined implicitly with AND, never OR.

key:value matches items whose key is value — e.g. status:success.

  • Negation — put - in front of a filter to exclude what it matches: -status:success.
  • Multiple values — group them with OR inside parentheses: status:(success OR failure). The group belongs to one key, and OR has to be capitalized.

Searching free text 

Some search boxes also accept free text filters (any filter without a key/: is free text). For example, timeout searches for that word, and -timeout excludes it. You may query for free text without quotes, unless a special character is used.

Quoting 

Wrap a filter in double quotes to search for exactly what is inside them. Quote a filter that contains a space, a parenthesis, a quote, a backslash, or a : you mean literally:

  • name:"my app" — a value with a space in it.
  • "status: success" — the text status: success, not a key:value filter.

Escapes 

A backslash only escapes a quote or another backslash, and only inside quotes. Anywhere else — outside quotes, before any other character, or trailing at the end of a quoted string — it’s highlighted as an error:

  • "a \"quoted\" word" — text holding double quotes.
  • "C:\\dir" — text holding a backslash.

Examples 

QueryMatches
status:successItems whose status is success.
-status:successEverything whose status is not success.
status:(success OR failure)Items whose status is either one.
status:success timeoutItems whose status is success AND that match the text timeout.
name:"my app"Items named exactly my app.
timeoutItems matching the text timeout.
-timeoutItems not matching the text timeout.
-"connection timeout"Items not matching the text connection timeout.
"-timeout"Items matching the text -timeout, which is not negated.
"status: success"Items matching the text status: success, since quoting forces text.
foo:barItems matching the text foo:bar, highlighted because foo isn’t a field.
"C:\dir"An error — \d doesn’t escape anything.
"C:\\dir"Items matching the text C:\dir.