MongoDB——配置文件详解

绝地灬酷狼 2023-10-09 22:11 39阅读 0赞

### 配置文件 ###

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>    #过滤器，可限制审计系统记录的操作类型