Skip to main content

AsyncAPI

Experimental
Creates:
AssetsLineage

Configure in the UI

This plugin can be configured directly in the Marmot UI with a step-by-step wizard.

View Guide

Example Configuration


spec_path: "/app/asyncapi-specs"
environment: "production"
discover_services: true
discover_channels: true
discover_messages: true
tags:
- "asyncapi"
- "event-driven"
filter:
include:
- "orders.*"
- "users.*"

Configuration

The following configuration options are available:

PropertyTypeRequiredDescription
discover_channelsboolfalseCreate channel/topic assets from channels and bindings
discover_messagesboolfalseAttach message schemas to channel assets
discover_servicesboolfalseCreate service assets from AsyncAPI info
environmentstringfalseEnvironment name (e.g., production, staging)
external_links[]ExternalLinkfalseExternal links to show on all assets
filterFilterfalseFilter discovered assets by name (regex)
spec_pathstringfalsePath to AsyncAPI spec file or directory containing specs
tagsTagsConfigfalseTags to apply to discovered assets

Available Metadata

The following metadata fields are available:

FieldTypeDescription
allowed_regions[]stringAllowed persistence regions
asyncapi_versionstringAsyncAPI specification version
binding_isstringAMQP binding type (queue or routingKey)
channel_addressstringAddress/topic of the channel
channel_countintNumber of channels
channel_namestringName of the channel in the AsyncAPI spec
cleanup_policy[]stringTopic cleanup policies
contact_emailstringContact email address
contact_namestringContact person name
contact_urlstringContact URL
content_deduplicationboolWhether content-based deduplication is enabled
deduplication_scopestringScope of deduplication if enabled
delete_retention_msint64Time to retain deleted messages
delivery_delayintDelivery delay in seconds
descriptionstringDescription of the resource
dlq_namestringName of the Dead Letter Queue
environmentstringEnvironment the resource belongs to
exchange_auto_deleteboolExchange auto delete flag
exchange_durableboolExchange durability flag
exchange_namestringExchange name
exchange_typestringExchange type (topic, fanout, direct, etc.)
exchange_vhoststringExchange virtual host
fifo_queueboolWhether this is a FIFO queue
fifo_throughput_limitstringFIFO throughput limit type
licensestringLicense name
license_urlstringLicense URL
max_message_bytesintMaximum message size
max_receive_countintMaximum receives before sending to DLQ
message_retention_durationstringMessage retention duration
message_retention_periodintMessage retention period in seconds
operation_countintNumber of operations
ordering_typestringSNS topic ordering type
partitionsintNumber of partitions
protocols[]stringList of protocols used
queue_auto_deleteboolQueue auto delete flag
queue_durableboolQueue durability flag
queue_exclusiveboolQueue exclusivity flag
queue_namestringName of the SQS queue
queue_namestringQueue name
queue_vhoststringQueue virtual host
receive_message_wait_timeintLong polling wait time in seconds
replicasintNumber of replicas
retention_bytesint64Maximum size of the topic
retention_msint64Message retention period in milliseconds
schema_encodingstringSchema encoding format
schema_namestringSchema name
servers[]stringList of server names
service_namestringName of the service that owns the resource
service_versionstringVersion of the service
topic_arnstringSNS Topic ARN
topic_namestringKafka topic name
topic_namestringGoogle Pub/Sub topic name
topic_namestringSNS Topic Name
visibility_timeoutintVisibility timeout in seconds