MongoDB——配置文件详解
配置文件
MongoDB常用配置参数可以由config配置文件统一设置实现。Mongod的配置文件是mongod…yaml,Mongos的配置文件为mongos.yaml。MongoDB在2.6版本开始,配置文件
采用YAML格式。在使用配置文件前,先需要手工建立YAML配置文件内容,配置文件详细内容可以参考后续网络配置、存储配置内容。
配置文件模块
net: #网络 systemLog: #日志 storage: #存储引擎 processManagement: #进程管理 security: #安全 operationProfiling: #性能分析器 replication: #主从复制 sharding: #分片集群 setParameter: #自定义变量 auditLog: #监测日志 snmp:
网络模块
net: prot: <int> #监听端口,默认27017 bindIp: <string> #绑定IP,如果此值是“0.0.0.0”则绑定所有接口,允许多ip绑定,用逗号分隔 maxIncomingConnections: <int> #进程允许的最大连接数,上限是系统阈值(ulimit),默认65535 wireObjectCheck: <boolean> #当客户端写入数据时,是否检查数据的有效性(BSON),有效的数据才执行,默认true ipv6: <bool> #是否支持多实例之间使用ipv6,默认false http: #http配置 3.2以后弃用,不安全 enabled: <boolean> JSONEnabled: <boolean> RESTInterfaceEnabled: <boolean> ssl: #https配置 sslOnNormalPorts: <boolean> mode: <string> PEMKeyFile: <string> PEMKeyPassword: <string> clusterFile: <string> clusterPassword: <string> CAFile: <string> CRLFile: <string> allowConnectionsWithoutCertificates: <boolean> allowInvalidCertificates: <boolean> allowInvalidHostnames: <boolean> disabledProtocols: <string> FIPSMode: <boolean> compression: #数据压缩 3.4支持Snappy压缩器 compressors: <string>
日志模块
systemLog: verbosity: <int> #日志级别,默认0,1-5均会包含debug信息 quiet: <bool> #安静,true时将会减少日志的输出量 traceAllExceptions: <bool> #打印异常详细信息 syslogFacility: <string> #启用syslog指定用于登录时信息到syslog Facility水平,前提是 path: <string> #日志路径 logAppend: <bool> #追加日志还是新建日志 logRotate: rename|reopen #日志轮询。默认值rename;reopen前提为 logAppend: true destination: <string> #日志输出目的地,可为file或syslog,不指定会输出到标准输出 timeStampFormat: <string> #日志时间戳格式,有 ctime,Iso869-utc,iso8691-local component: #为不同的组件指定各自的日志信息级别 accessControl: verbosity: <int> command: verbosity: <int>
存储引擎模块
storage: dbPath: <string> #数据存储目录 /data/db indexBuildRetry: <bool> #构件索引时mongod意外关闭,启动是否重建索引,默认true repairPath: <string> #在repair期间临时数据目录 A_tmp_repairDatabase_<num> journal: #数据操作记录日志 enabled: <boolean> #journal日志是否持久存储,通常用于数据故障恢复,建议开启 默认64位为true,32位为false commitIntervalMs: <num> #mongod日志刷新值,范围1-500毫秒,默认100,不建议修改 directoryPerDB: <bool> #是否将不同的数据存储在不同的目录中,需为dbPath子目录,默认false syncPeriodSecs: <int> #fsync操作将数据flush到磁盘的时间间隔,默认为60秒,不建议修改 engine: <string> #存储引擎类型,3.2前默认 mmapv1,3.2后默认WiredTiger wiredTiger: #存储引擎配置 engineConfig: cacheSizeGB: <number> #最大缓存大小256~10TB,3.4版本开始wridTiger默认:50%RAM减去1GB journalCompressor: <string> #日志压缩算法,可选值有 none,snappy(默认),zlib directoryForIndexes: <bool> #是否将索引和集合数据分别存储在dbPath单独的目录中,默认false collectionConfig: blockCompressor: <string> #collection数据压缩算法,可选none, snappy(默认),zlib indexConfig: prefixCompression: <bool> #是否对索引数据使用前缀压缩。可有效减少索引数据的内存使用量。默认true
进程管理模块
processManagement: fork: <boolean> #是否以守护进程运行,默认false pidFilePath: <string> #将mongod进程ID写入指定文件,默认不会创建
安全模块
security: authorization: enabled #MondoDB认证功能,默认disabled keyFile: /path/mongo.key #MongoDB副本集节点身份验证密钥文件 clusterAuthMode: <string> #集群members间的认证模式 transitionToAuth: <boolean> #过度方式授权,默认false javascriptEnabled: <boolean> #是否允许执行JavaScript脚本,默认true redactClientLogData: <boolean> #无业务数据日志记录方式,默认false sasl: #Sasl协议 hostName: <string> #实现基于Sasl和Kerberos协议支持的服务器域名设置 serviceName: <string> #设置基于Sasl协议的服务器注册名称。仅用于企业版 saslauthdSocketPath: <string> #设置Unix域Socket文件路径 enableEncryption: <boolean> #WiredTiger存储引擎加密,默认false(企业版) encryptionCipherMode: <string> #加密模式(企业版) encryptionKeyFile: <string> #带路径的加密密钥文件(企业版) kmip: #密钥管理协议(企业版) keyIdentifier: <string> rotateMasterKey: <boolean> serverName: <string> port: <string> clientCertificateFile: <string> clientCertificatePassword: <string> serverCAFile: <string> ldap: #轻量目录访问协议(企业版) servers: <string> bind: method: <string> saslMechanism: <string> queryUser: <string> queryPassword: <string> useOSDefaults: <boolean> transportSecurity: <string> timeoutMS: <int> userToDNMapping: <string> authz: queryTemplate: <string>
性能分析器
operationProfiling: slowOpThresholdMs: <int> #“慢查询”的时间阈值,单位毫秒(默认100ms) mode: <string> #数据库profiler级别,可选值“off|slowOp|all” # 数据库profiling会影响性能,建议只在性能调试阶段开启,mongod会把慢查询记录到日志中
replication副本集相关参数
replication: oplogSizeMB: <int> #replication操作日志的最大尺寸,如果太小则全量同步 replSetName: <string> #副本集名称,副本集中所有的mongod实例都必须有相同的名字 secondaryIndexPrefetch: <string> #副本集中的secondary,从oplog中应用变更操作前,会先把索引加载到内存 enalbeMajorityReadConcern: <boolean> #允许readConcern的级别为“majority”
sharding分片相关参数
sharding: clusterRole: <string> #在sharding集群中的角色。configsvr(27019)|shardsvr(27018) archiveMovedChunks: <bool> #当chunks迁移后,是否归档并保存这些chunks在dbPath/movechunk目录下
setParameter自定义变量
setParameter: <parameter1>: <value1> <parameter2>: <value2> enableLocalhostAuthBypass: false #示例
auditLog审计相关参数:
auditLog: destination: <string> #指定审计记录的输出方式,有syslog|console|file format: <string> #输出格式,有JSON 和 BSON path: <string> #如果输入为文件,那么指定文件完整路径及文件名 filter: <string> #过滤器,可限制审计系统记录的操作类型