3.9 KiB
3.9 KiB
MongoDB writer
MongoDB writer provides message repository implementation for MongoDB.
Configuration
The service is configured using the environment variables presented in the following table. Note that any unset variables will be replaced with their default values.
| Variable | Description | Default |
|---|---|---|
| MF_MONGO_WRITER_LOG_LEVEL | Log level for MongoDB writer | info |
| MF_MONGO_WRITER_CONFIG_PATH | Config file path with Message broker subjects list, payload type and content-type | /config.toml |
| MF_MONGO_WRITER_HTTP_HOST | Service HTTP host | localhost |
| MF_MONGO_WRITER_HTTP_PORT | Service HTTP port | 9010 |
| MF_MONGO_WRITER_HTTP_SERVER_CERT | Service HTTP server certificate path | "" |
| MF_MONGO_WRITER_HTTP_SERVER_KEY | Service HTTP server key | "" |
| MF_MONGO_NAME | Default MongoDB database name | messages |
| MF_MONGO_HOST | Default MongoDB database host | localhost |
| MF_MONGO_PORT | Default MongoDB database port | 27017 |
| MF_MESSAGE_BROKER_URL | Message broker instance URL | nats://localhost:4222 |
| MF_JAEGER_URL | Jaeger server URL | http://jaeger:14268/api/traces |
| MF_SEND_TELEMETRY | Send telemetry to mainflux call home server | true |
| MF_MONGO_WRITER_INSTANCE_ID | MongoDB writer instance ID | "" |
Deployment
The service itself is distributed as Docker container. Check the mongodb-writer service section in docker-compose to see how service is deployed.
To start the service, execute the following shell script:
# download the latest version of the service
git clone https://github.com/mainflux/mainflux
cd mainflux
# compile the mongodb writer
make mongodb-writer
# copy binary to bin
make install
# Set the environment variables and run the service
MF_MONGO_WRITER_LOG_LEVEL=[MongoDB writer log level] \
MF_MONGO_WRITER_CONFIG_PATH=[Configuration file path with Message broker subjects list] \
MF_MONGO_WRITER_HTTP_HOST=[Service HTTP host] \
MF_MONGO_WRITER_HTTP_PORT=[Service HTTP port] \
MF_MONGO_WRITER_HTTP_SERVER_CERT=[Service HTTP server certificate] \
MF_MONGO_WRITER_HTTP_SERVER_KEY=[Service HTTP server key] \
MF_MONGO_NAME=[MongoDB database name] \
MF_MONGO_HOST=[MongoDB database host] \
MF_MONGO_PORT=[MongoDB database port] \
MF_MESSAGE_BROKER_URL=[Message broker instance URL] \
MF_JAEGER_URL=[Jaeger server URL] \
MF_SEND_TELEMETRY=[Send telemetry to mainflux call home server] \
MF_MONGO_WRITER_INSTANCE_ID=[MongoDB writer instance ID] \
$GOBIN/mainflux-mongodb-writer
Usage
Starting service will start consuming normalized messages in SenML format.