Documentation for automated readers
A curated documentation index is available at: https://grafana.com/llms.txt
A complete documentation index is available at: https://grafana.com/llms-full.txt
These indexes can help with page discovery before fetching individual documents.
This page is also available in Markdown, which may be easier for automated readers and AI tools to parse than HTML. The Markdown version is available at https://grafana.com/docs/grafana-cloud/send-data/alloy/reference/config-blocks/import.string.md, or by sending Accept: text/markdown to https://grafana.com/docs/grafana-cloud/send-data/alloy/reference/config-blocks/import.string/. For broader documentation discovery, the curated index is available at https://grafana.com/llms.txt and the complete index is available at https://grafana.com/llms-full.txt.
import.string
The import.string block imports custom components from a string and exposes them to the importer.
import.string blocks must be given a label that determines the namespace where custom components are exposed.
Usage
import.string "<NAMESPACE>" {
content = <CONTENT>
}Arguments
You can use the following argument with import.string:
| Name | Type | Description | Default | Required |
|---|---|---|---|---|
content | secret or string | The contents of the module to import as a secret or string. | yes |
content is a string that contains the configuration of the module to import.
content is typically loaded by using the exports of another component. For example,
local.file.<LABEL>.contentremote.http.<LABEL>.contentremote.s3.<LABEL>.content
Example
This example imports a module from the content of a file stored in an S3 bucket and instantiates a custom component from the import that adds two numbers:
remote.s3 "module" {
path = "s3://test-bucket/module.alloy"
}
import.string "math" {
content = remote.s3.module.content
}
math.add "default" {
a = 15
b = 45
}Was this page helpful?
Related resources from Grafana Labs


