환경 구성 설정

모든 플랜 에서 사용 가능

Tip

아래 각 구성 값은 JSON-aware 도구를 사용하여 config.json 파일에서 프로그래밍 방식으로 값을 액세스하기 위한 JSON 경로를 포함합니다. 예를 들어 SiteURL 값은 ServiceSettings 아래에 있습니다.

jq 와 같은 도구를 사용하는 경우, 다음을 입력하십시오: cat config/config.json | jq '.ServiceSettings.SiteURL'
config.json 파일을 수동으로 처리하는 경우, ServiceSettings 키를 찾은 다음 해당 개체 내에서 SiteURL 키를 찾으십시오.

자체 호스트 및 클라우드 관리자 모두 시스템 콘솔 > 환경 에서 다음 구성 설정에 액세스할 수 있습니다. 자체 호스트 관리자는 아래 표에 설명된대로 config.json 파일을 편집할 수도 있습니다.

웹 서버
데이터베이스
Elasticsearch
파일 저장소
이미지 프록시
SMTP
푸시 알림 서버
고가용성
속도 제한
로깅
세션 길이
성능 모니터링
개발자

웹 서버

모든 플랜 에서 사용 가능

self-hosted 배포판

Mattermost가 배포된 네트워크 환경을 구성하려면 시스템 콘솔 > 환경 > 웹 서버 로 이동하거나, 다음 테이블에 설명된 대로 config.json 파일을 업데이트하세요. 이 섹션의 구성 설정 변경은 적용되기 전에 서버를 다시 시작해야 합니다.

사이트 URL

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

사용자가 Mattermost에 액세스하는 데 사용하는 URL입니다. 표준 포트가 아닌 경우 포트 번호가 필요합니다. 이 필드는 필수입니다.

시스템 콘솔에서 라이브 URL 테스트 버튼을 선택하여 사이트 URL을 유효성 검사합니다.

시스템 구성 경로: 환경 > 웹 서버
config.json 설정: .ServiceSettings.SiteURL",
환경 변수: MM_SERVICESETTINGS_SITEURL

참고:

URL에 하위 경로가 포함될 수 있습니다. (”https://example.com/company/mattermost”와 같이)
Site URL 값을 변경하면 데스크톱 앱에서 로그아웃하고 새 도메인을 사용하여 다시 로그인해야 합니다.
Site URL이 설정되지 않은 경우:
- 이메일 알림에는 손상된 링크가 포함되며 이메일 배치가 작동하지 않습니다.
- OAuth 2.0을 통한 인증(예: GitLab, Google 및 Office 365)이 실패합니다.
- 플러그인이 예상대로 작동하지 않을 수 있습니다.

웹 서버 수신 주소

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

바인딩 및 수신할 주소와 포트입니다. :8065를 지정하면 모든 네트워크 인터페이스에 바인딩됩니다. 127.0.0.1:8065를 지정하면 해당 IP 주소를 가진 네트워크 인터페이스에만 바인딩됩니다.

낮은 수준의 포트(“시스템 포트” 또는 “잘 알려진 포트”로 불리는 0-1023 범위 내)를 선택하는 경우 해당 포트에 바인딩할 권한이 있어야 합니다.

시스템 구성 경로: 환경 > 웹 서버
config.json 설정: ServiceSettings.ListenAddress s",
환경 변수: MM_SERVICESETT INGS_LISTENADDRESS

포트 80을 443으로 전달

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

포트 80에서 443으로 보안되지 않은 트래픽을 전달합니다.

true : 포트 80에서 모든 보안되지 않은 트래픽을 안전한 포트 443으로 전달합니다.
false : (기본값) Mattermost 앞에 NGINX와 같은 프록시를 사용하는 경우이 설정은 불필요하며 false로 설정해야 합니다.

시스템 구성 경로: 환경 > 웹 서버
config.json 설정: ".ServiceSettings .Forward80To443: false",
환경 변수: MM_SERVIC ESETTINGS_FORWARD80TO443

웹 서버 연결 보안

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Mattermost 클라이언트와 서버 간의 연결 보안입니다.

지정되지 않음 : Mattermost는 보안되지 않은 연결을 통해 연결합니다.
TLS : Mattermost 클라이언트와 서버 간의 통신을 암호화합니다. 자세한 내용은 Mattermost에서 TLS 구성 을 참조하세요.

시스템 구성 경로: 환경 > 웹 서버
config.json 설정: ".ServiceSettings .ConnectionSecurity",
환경 변수: MM_SERVICESETTINGS_ CONNECTIONSECURITY

TLS 인증서 파일

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

TLS 연결 보안에 사용할 인증서 파일의 경로입니다.

문자열 입력입니다.

시스템 구성 경로: 환경 > 웹 서버
config.json 설정:

".ServiceSettings.TLSCertFile", - 환경 변수:

MM_SERVICESETTINGS_TLSCERTFILE

TLS 키 파일

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

TLS 연결 보안에 사용할 TLS 키 파일의 경로입니다.

문자열 입력입니다.

시스템 구성 경로: Environment > Web Server
config.json 설정: ".ServiceSett ings.TLSKeyFile",
환경 변수: MM_SERVICE SETTINGS_TLSKEYFILE

Let’s Encrypt 사용

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Let’s Encrypt에서 인증서를 자동으로 가져오도록 설정합니다. Let’s Encrypt 설정에 대한 자세한 내용은 Mattermost 문서에서 TLS 구성 을 참조하세요.

true : 클라이언트가 새 도메인에서 연결을 시도할 때 인증서가 가져옵니다. 여러 도메인과 작동합니다.
false : (기본값) TLS 인증서 파일 및 TLS 키 파일을 기반으로 수동으로 인증서를 지정합니다.

시스템 구성 경로: Environment > Web Server
config.json 설정: ".ServiceSettings.Use LetsEncrypt: false",
환경 변수: MM_SERVICESETTINGS _USELETSENCRYPT

Let’s Encrypt 인증서 캐시 파일

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Let’s Encrypt 서비스에 대한 인증서 및 기타 데이터를 저장할 파일의 경로입니다.

파일 경로 입력입니다.

시스템 구성 경로: Environment > Web Server
config.json 설정: ".ServiceSettings.LetsE ncryptCertificateCacheFile",
환경 변수: MM_SERVICESETTINGS_LETSE NCRYPTCERTIFICATECACHEFILE

읽기 시간 초과

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

연결 수락부터 요청 본문이 완전히 읽힐 때까지 허용되는 최대 시간입니다.

초 단위의 숫자 입력입니다. 기본값은 300 초입니다.

시스템 구성 경로: Environment > Web Server
config.json 설정: ".ServiceSetting s.ReadTimeout: 300",
환경 변수:

MM_SERVICESETTINGS_READTIMEOUT

쓰기 시간 초과

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

HTTP(보안되지 않은 경우)를 사용하는 경우 요청 헤더를 읽은 후 응답을 쓰는 데 허용된 최대 시간입니다.
HTTPS를 사용하는 경우 연결이 수락되면부터 응답이 쓰여질 때까지의 총 시간입니다.

초 단위의 숫자 입력입니다. 기본값은 300 초입니다.

시스템 구성 경로: Environment > Web Server
config.json 설정: ".ServiceSettings .WriteTimeout: 300",
환경 변수:

MM_SERVICESETTINGS_WRITETIMEOUT

유휴 시간 초과

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

HTTP 서버에서 명시적인 유휴 시간 초과를 설정합니다. 유휴 상태의 연결이 끊기기 전에 허용되는 최대 시간입니다.

초 단위의 숫자 입력입니다. 기본값은 300 초입니다.

시스템 구성 경로: Environment > Web Server
config.json 설정: ".ServiceSetti ngs.IdleTimeout: 300",
환경 변수:

MM_SERVICESETTINGS_IDLETIMEOUT

웹서버 모드

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

웹 프락시가 gzip 파일을 잘 처리하지 않는 등 특정 제약 사항이 있는 경우를 제외하고 성능을 향상시키기 위해 gzip을 권장합니다.

gzip : (기본값) Mattermost 서버는 Mattermost 웹 클라이언트를 구성하는 HTML, CSS, Javascript 및 기타 정적 콘텐츠 파일을 압축하여 성능을 향상시킵니다.
미압축 : Mattermost 서버는 정적 파일을 미압축으로 제공합니다.
비활성화 : Mattermost 서버는 정적 파일을 제공하지 않습니다.

시스템 구성 경로: Environment > Web Server

config.json 설정: ".ServiceSettings.WebserverMode: gzip",

안전하지 않은 외부 연결 활성화

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Mattermost를 구성하여 안전하지 않은 외부 연결을 허용합니다.

true : S3 클라이언트를 포함한 외부 HTTPS 요청이 확인되지 않은, 자체 서명된 인증서를 수락할 수 있습니다. 예를 들어, 자체 서명된 TLS 인증서를 가진 서버로의 외부 웹훅이 허용되며, TLS 확인을 건너뛸 것입니다.
false : (기본값) 안전한 HTTPS 요청만 허용됩니다.

시스템 구성 경로: 환경 > 웹 서버
config.json 설정: ".ServiceSettings.EnableInsec ureOutgoingConnections: false",
환경 변수: MM_SERVICESETTINGS_ENABLE INSECUREOUTGOINGCONNECTIONS

보안 참고 : 이 기능을 활성화하면 이러한 연결이 중간자 공격에 취약해집니다.

관리되는 리소스 경로

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Mattermost 도메인 내에서 Mattermost 자체가 아닌 서드 파티 서비스에 의해 관리되는 경로들의 쉼표로 구분된 목록입니다.

Mattermost 앱에서 이러한 경로에 대한 링크는 새 탭/창에서 열립니다.

예를 들어, 만약 Mattermost가 https ://mymattermost.com에서 실행 중이라면, 이를 conference로 설정하면 https://mymatt ermost.com/conference와 같은 링크들이 새 창에서 열립니다.

시스템 구성 경로: 환경 > 웹 서버
config.json 설정: ".ServiceSettings.Ma nagedResourcePaths",
환경 변수: MM_SERVICESETTINGS _MANAGEDRESOURCEPATHS

참고 : Mattermost 데스크톱 앱을 사용할 때는 링크를 브라우저가 아닌 데스크톱 앱에서 열기 위해 추가 구성이 필요합니다. 자세한 내용은 데스크톱 관리 리 소스 문서를 참조하세요.

디스크로부터 구성 다시 불러오기

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

서버를 중지시키지 않고 장애 조치를 위해 config.json 파일의 데이터베이스 라인을 바꾼 후 구성을 다시 불러와야 합니다.

데이터베이스 구성을 변경한 후 시스템 콘솔에서 디스크로부터 구성 다시 불러오기 버튼을 선택하세요. 그리고나서 환경 > 데이터베이스 로 이동하여 데이터베이스 연결 재생성 을 선택하여 구성을 완료하세요.

시스템 구성 경로: 환경 > 웹 서버
config.json 설정: N/A
환경 변수: N/A

모든 캐시 삭제

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

세션, 계정 및 채널에 대한 모든 인메모리 캐시를 삭제해야 합니다.

시스템 콘솔에서 모든 캐시를 삭제하는 모든 캐시 삭제 버튼을 선택하세요.

시스템 구성 경로: 환경 > 웹 서버
config.json 설정: N/A
환경 변수: N/A

참고 : 캐시를 삭제하는 것은 성능에 불이익을 줄 수 있습니다. 고가용성 클러스터 를 사용하는 배포는 클러스터의 모든 서버를 삭제하려고 할 것입니다.

웹소켓 URL

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

클라이언트에게 웹소켓을 연결하도록 서버를 구성할 수 있습니다.

문자열 입력.

시스템 구성 경로: N/A
config.json 설정: ".ServiceSetti ngs.WebsocketURL: "",
환경 변수:

MM_SERVICESETTINGS_WEBSOCKETURL

라이선스 파일 위치

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

디스크상의 라이선스 파일의 경로와 파일 이름입니다. 부팅 시, Mattermost가 이전 업로드에서 데이터베이스에 유효한 라이선스를 찾지 못하면, 이 경로에서 라이선스 파일을 검색합니다.

문자열 입력. 절대 경로 또는 mattermost 디렉터리에 상대적인 경로입니다.

시스템 구성 경로: N/A
config.json 설정: ".ServiceSetti ngs.LicenseFileLocation: "",
환경 변수: MM_SERVICESE TTINGS_LICENSEFILELOCATION

TLS 최소 버전

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Mattermost 서버에서 사용하는 최소 TLS 버전입니다.

문자열 입력. 기본값은 1.2 입니다.

시스템 구성 경로: N/A
config.json 설정: ".ServiceSetti ngs.TLSMinVer: 1.2",
환경 변수: MM_SERVICESETTINGS_TLSMINVER

참고 : 이 설정은 내장된 서버 이진 파일을 직접 사용하고 NGINX와 같은 리버스 프록시 계층을 사용하지 않는 경우에만 영향을 미칩니다.

신뢰할 수 있는 프록시 IP 헤더

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

IP 주소를 순서대로 확인할 지정된 헤더입니다. 다른 모든 헤더는 무시됩니다.

["X-Forwarde d-For", "X-Real-Ip"]와 같은 헤더 이름으로 구성된 문자열 배열 입력.

시스템 구성 경로: N/A
config.json 설정: ".ServiceSettin gs.TrustedProxyIPHeader: []",
환경 변수: MM_SERVIC ESETTINGS_TRUSTEDPROXYIPHEADER

참고사항 :

[]의 기본값은 아무 헤더도 신뢰하지 않음을 의미합니다. v5.12 이전에는 이 설정 항목이 없으면 후속 호환성을 유지하기 위해 업그레이드시 ["X-Forwarde d-For", "X-Real-Ip"] 로 설정됩니다.
프록시를 사용하지 않고 Mattermost를 실행하는 경우, 클라이언트가 헤더를 전송하고 속도 제한을 우회하거나 감사 로그를 우회하는 것을 피하기 위해 기본 설정을 유지하는 것을 권장합니다.
리버스 프록시를 사용하는 환경에서는 해당 환경에서 헤더가 설정되었는지 확인하고 추가 값은 허용하지 말아야 합니다.

Strict Transport Security (HSTS) 활성화

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

true : 모든 응답에 Strict Transport Security (HSTS) 헤더를 추가하여 브라우저가 모든 리소스를 HTTPS를 통해 요청하도록 강제합니다. false : (기본값) TLS 전송에 대한 제한이 없습니다. Strict Transport Security (HSTS) 헤더가 응답에 추가되지 않습니다.	시스템 구성 경로: N/A `config.json` 설정: `".ServiceSettin gs.TLSStrictTransport: false",` 환경 변수: `MM_SERVI CESETTINGS_TLSSTRICTTRANSPORT`
Strict-Tra nsport-Security 문서에서 자세한 내용을 확인하세요.

안전한 TLS 전송 만료

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

브라우저가 사이트를 HTTPS를 통해서만 액세스해야 함을 기억하는 시간(초). 이 기간 이후에는 ` TLSStrictTransport`가 true로 설정되지 않는 한 사이트에 HTTP를 통해 액세스할 수 없습니다.

숫자 입력. 기본값은 63072000 (2년) 입니다.

시스템 구성 경로: N/A
config.json 설정: ".ServiceSettings.TLSS trictTransportMaxAge: 63072000",
환경 변수: MM_SERVICESETTI NGS_TLSSTRICTTRANSPORTMAXAGE

Strict-Transpo rt-Security 문서에서 자세한 내용을 확인하세요.

TLS 암호 덮어쓰기

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

현재 고려되는 안전한 암호 집합을 사용하여 Mattermost 서버가 가정하는 경우, 또는 허용된 암호 유형을 제한하기 위해 TLS 암호 덮어쓰기를 설정합니다.

지정되지 않은 경우 엣지 케이스에서 덮어쓰기를 허용합니다.

문자열 배열 입력.

시스템 구성 경로: N/A
config.json 설정: ".ServiceSettings TLSOverwriteCiphers: []",
환경 변수: MM_SERVICESET TINGS_TLSOVERWRITECIPHERS

참고사항 : 이 설정은 내장 서버 바이너리를 직접 사용하고 NGINX와 같은 역방향 프록시 레이어를 사용하지 않을 때만 적용됩니다. - ServerTLSSupportedCiphers 변수에서 안전한 암호 목록을 확인하

려면 /model/config.go 의 해당 파일을 참조하세요.

안전한 암호 목록을 확인하려면 /model/config.go 의 해당 파일을 참조하세요.

고루틴 상태 임계값

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

매터모스트 시스템이 건강한 상태로 간주되는 고루틴의 수에 대한 임계값 설정.

고루틴이 이 한도를 초과하면 서버 로그에 경고가 표시됩니다.

숫자 입력. 기본값은 -1입니다. 이 값은 임계값 확인을 끕니다.

시스템 구성 경로: 없음
config.json 설정: ".ServiceSettings.Gor outineHealthThreshold: -1",
환경 변수: MM_SERVICESET TINGS_GOROUTINEHEALTHTHRESHOLD

서브도메인에 대한 쿠키 허용

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

true : (기본값) 서브도메인에 대한 쿠키 허용 을 활성화하려면 매터모스트 쿠키의 도메인 매개변수를 설정합니다.
false : 서브도메인에 대한 쿠키 허용하지 않음.

시스템 구성 경로: 없음
config.json 설정: ".ServiceSettings.Allow CookiesForSubdomains: true",
환경 변수: MM_SERVICESETTINGS_A LLOWCOOKIESFORSUBDOMAINS

클러스터 로그 시간 제한

이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.

클러스터 요청 시간 로깅 주기를 정의합니다. 성능 모니터링을 위한 밀리초(millisecond) 단위.

숫자 입력. 기본값은 2000 밀리초(2초)입니다.

시스템 구성 경로: 없음
config.json 설정: “.ServiceSettings.ClusterLogTimeoutMilliseconds: 2000”,
환경 변수: MM_SERVICESETTINGS_CLUSTERLOGTIMEOUTMILLISECONDS

자세한 내용은 성능 모니터링(performance monitoring) 문서를 참조하세요.

데이터베이스

모든 플랜 에서 사용 가능

self-hosted 배포판

드라이버 이름

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

데이터베이스 유형입니다. 다음 중 하나를 사용할 수 있습니다:

mysql : (기본값) MySQL 데이터베이스로의 드라이버를 활성화합니다.
postgres : PostgreSQL 데이터베이스로의 드라이버를 활성화합니다.

시스템 구성 경로: N/A
config.json 설정: ".SqlSettings.DriverName",
환경 변수: MM_SQLSETTINGS_DRIVERNAME

데이터 원본

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

마스터 데이터베이스로의 연결 문자열입니다. 문자열 입력입니다.	시스템 구성 경로: N/A `config.json` 설정: `".SqlSettings.DataSource",` 환경 변수: `MM_SQLSETTINGS_DATASOURCE`
SSL을 활성화하려면: SQL 드라이버가 지원하는 경우 데이터베이스 연결 문자열에 `&tls=true`를 추가하십시오. 자체 서명된 인증서를 사용하는 경우 `&tls=skip-verify`를 추가하십시오.
PostgreSQL 데이터베이스 드라이버 이름 이 `postgres`로 설정된 경우, 다음과 같은 형식의 연결 문자열을 사용하십시오: `postg res://mmuser:password@localhos t:5432/mattermost_test?sslmode =disable&connect_timeout=10.`
MySQL 데이터베이스 드라이버 이름 이 `mysql`로 설정된 경우, `charset` 대신 `collation`을 사용하는 것이 권장됩니다. 정렬 순서를 지정하려면: "SqlSettings": { "DataSource": "<user:pass>@<servername>/ma ttermost?charset=utf8mb4,u tf8&collation=utf8mb4_gener al_ci", [...] } 정렬 순서를 지정하지 않으면 기본 정렬 순서인 `utf8mb4_general_ci`가 사용됩니다: "SqlSettings": { "DataSource": "<user:pass>@<servername>/mat termost?charset=utf8mb4 ,utf8", [...] } 참고 : MySQL 8.0 이상을 사용하는 경우, 기본 정렬 순서가 `utf8mb4_0900_ai_ci`로 변경되었습니다. MySQL 8.0 지원에 대한 자세한 내용은 데이터베이스 소프트웨어 요구 사항 문서에서 확인하십시오.

최대 유휴 데이터베이스 연결

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

데이터베이스에 유지되는 최대 유휴 연결 수입니다.

숫자 입력입니다. 기본값은 10 입니다.

시스템 구성 경로: 환경 > 데이터베이스
config.json 설정: ".SqlSetti ngs.MaxIdleConns": 10,
환경 변수: MM_SQLSETTINGS_MAXIDLECONNS

최대 개방 연결

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

데이터베이스에 대한 최대 오픈 연결 수입니다.

숫자 입력입니다. 자체 호스팅 배포의 기본값은 300 이고, 클라우드 배포의 기본값은 100 입니다.

시스템 구성 경로: 환경 > 데이터베이스
config.json 설정: ".SqlSettings.Ma xOpenConns": 300,
환경 변수: MM_SQLSETTINGS_MAXOPENCONNS

쿼리 시간 초과

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

연결을 열고 쿼리를 보내고 나서 데이터베이스로부터 응답을 기다리는 시간입니다.

초 단위로 숫자 입력입니다. 기본값은 30 초입니다.

시스템 구성 경로: 환경 > 데이터베이스
config.json 설정: ".SqlSettings. QueryTimeout: 30",
환경 변수: MM_SQLSETTINGS_QUERYTIMEOUT

최대 연결 수명

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

데이터베이스에 대한 연결의 최대 수명(밀리초 단위). 데이터베이스에 대한 연결을 재사용할 수 있는 최대 시간을 구성하는 데 사용됩니다.

밀리초(millisecond)로 숫자 입력. 기본값은 3600000 밀리초(1시간)입니다.

시스템 구성 경로: 환경 > 데이터베이스
config.json 설정: ".SqlSettings.ConnMaxLifetime Milliseconds: 3600000",
환경 변수: MM_SQLSETTINGS_CONNMA XLIFETIMEMILLISECONDS

최대 연결 대기 시간

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

데이터베이스 연결이 대기할 수 있는 최대 시간(밀리초 단위).

밀리초(millisecond)로 숫자 입력. 기본값은 300000 밀리초(5분)입니다.

시스템 구성 경로: 환경 > 데이터베이스
config.json 설정: ".SqlSettings.ConnMaxIdleTime Milliseconds: 300000",
환경 변수: MM_SQLSETTINGS_CO NNMAXIDLETIMEMILLISECONDS

최소 해시태그 길이

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

해시태그 내 문자의 최소 수. 이 값은 2 이상이어야 합니다.	시스템 구성 경로: 환경 > 데이터베이스 `config.json` 설정: `".SqlSettings.Min imumHashtagLength: 3",` 환경 변수: `MM_SQLSETTINGS_MI NIMUMHASHTAGLENGTH`
참고 : MySQL 데이터베이스는 세 글자보다 짧은 문자열을 검색할 수 있도록 구성되어야 합니다. 자세한 내용은 MySQL 문서 를 참조하세요.

SQL 문 로깅

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

실행된 SQL 문을 개발을 위해 로그에 기록할 수 있습니다.

true : SQL 문 실행이 로그에 기록됩니다.
false : (기본값) SQL 문이 로그에 기록되지 않습니다.

시스템 구성 경로: 환경 > 데이터베이스
config.json 설정: ".SqlSettings.Trace: false",
환경 변수: MM_SQLSETTINGS_TRACE

데이터베이스 연결 재사용

이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.

데이터베이스 연결 재활용 버튼을 선택하여 데이터베이스로의 현재 오픈된 연결 세트를 20초 이내에 닫고, 새로운 연결 세트를 만듭니다.

서버를 중지하지 않고 장애 조치하려면, config.json 파일에서 데이터베이스 라인을 변경한 후, 환경 > 웹 서버 에서 디스크에서 구성 다시 불러오기 를 선택한 다음, 데이터베이스 연결 재사용 을 선택하세요.

시스템 구성 경로: 환경 > 데이터베이스
config.json 설정: 없음
환경 변수: 없음

데이터베이스 검색 비활성화

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Elasticsearch 와 같은 다른 검색 엔진이 구성된 경우, 데이터베이스를 비활성화하여 검색을 수행할 수 있습니다.

true : 데이터베이스를 사용하여 검색을 수행하지 않도록 설정합니다. 다른 검색 엔진이 구성되지 않은 경우, 이 값을 true로 설정하면 빈 검색 결과가 반환됩니다.
false : (기본값) 데이터베이스 검색이 비활성화되지 않습니다.

시스템 구성 경로: 환경 > 데이터베이스
config.json 설정: ".SqlSettings.DisableDa tabaseSearch: false",
환경 변수: MM_SQLSETTINGS_D ISABLEDATABASESEARCH

Mattermost에서의 검색 동작은 사용 가능한 검색 엔진에 따라 다릅니다.

Elasticsearch가 활성화된 경우, Mattermost는 먼저 이를 사용하려고 시도합니다.
만약 Elasticsearch가 실패하거나 비활성화된 경우, 활성화된 경우 Bleve를 사용하려고 시도할 것입니다. 그렇게 될 경우 Encountered error on Sea rchPostsInTeamForUser. 경고가 표시됩니다.
모든 것이 실패하거나 비활성화된 경우, Mattermost는 직접 데이터베이스를 검색하려고 할 것입니다.
위의 모든 방법이 실패하거나 비활성화된 경우, 검색 결과는 비어있게 됩니다.

적용된 스키마 마이그레이션

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

데이터 스토어에서 사용 가능한 버전 정보를 기반으로 적용된 모든 마이그레이션 리스트가 db_migrations 테이블에서 확인 가능합니다. 배포된 현재 데이터베이스 스키마 버전을 검토하려면 제품 메뉴에서 Mattermost 정보 를 선택하세요.

활성 검색 백엔드

검색에 사용되는 현재 활성화된 백엔드의 읽기 전용 표시입니다. 값은 none, database, elasticsearch, bleve를 포함할 수 있습니다.

리드 레플리카

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

리드 레플리카 데이터베이스의 연결 문자열을 지정합니다.	시스템 구성 경로: 해당 없음 `config.json` 설정: `".SqlSettings.D ataSourceReplicas": []` 환경 변수: `MM_SQLSETTINGS _DATASOURCEREPLICAS`
참고 : 배열 내의 각 데이터베이스 연결 문자열은 데이터 원본 설정과 사용하는 동일한 형식이어야 합니다.

검색 레플리카

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

검색 레플리카 데이터베이스의 연결 문자열을 지정합니다. 검색 레플리카는 리드 레플리카와 유사하지만 검색 쿼리 처리에만 사용됩니다.	시스템 구성 경로: 해당 없음 `config.json` 설정: `".SqlSettings.DataSo urceSearchReplicas": []` 환경 변수: `MM_SQLSETTINGS_DATASO URCESEARCHREPLICAS`
참고 : 배열 내의 각 데이터베이스 연결 문자열은 데이터 원본 설정과 사용하는 동일한 형식이어야 합니다.

레플리카 랙 설정

이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.

문자열 배열 입력은 단일 레플리카 인스턴스에 대해 레플리카 랙을 측정하기 위한 연결 문자열 및 사용자 정의 SQL 쿼리를 지정합니다.

이러한 설정은 바이너리 로그 거리/트랜잭션 대기열 길이를 기반으로 절대 랙을 모니터링하며, 레플리카가 따라잡는 데 걸리는 시간을 측정합니다.

문자열 배열 입력은 다음을 포함합니다:

DataSource: 데이터베이스 자격 증명으로 데이터베이스 인스턴스에 연결합니다.
QueryAbsoluteLag: 단일 행을 반환해야 하는 일반 SQL 쿼리입니다. 첫 번째 열은 프로메테우스 지표의 노드 값이어야 하고, 두 번째 열은 절대 랙을 측정하는 데 사용되는 값이어야 합니다.
QueryTimeLag: 단일 행을 반환해야 하는 일반 SQL 쿼리입니다. 첫 번째 열은 프로메테우스 지표의 노드 값이어야 하고, 두 번째 열은 시간 랙을 측정하는 데 사용되는 값이어야 합니다.

시스템 구성 경로: 해당 없음
config.json 설정: ".SqlSettings.Replic aLagSettings": []
환경 변수:

MM_SQLSETTINGS_REPLICALAGSETTINGS

참고 사항 :

QueryAbsoluteLag 및 QueryTimeLag 쿼리는 각각 하나의 행을 반환해야 합니다.
이를 올바르게 모니터링하려면 Mattermost에 대해 성능 모니터링 을 설정해야 합니다.

데이터베이스 유형에 따라 복제 지연 지표를 구성합니다. 각 데이터베이스 유형에 대한 구성 세부 정보는 다음 탭을 참조하십시오.

아래 강조된 구성을 SqlSettings.ReplicaLagSettings 배열에 추가하십시오. Aurora 노드에 대한 복제 통계는 클러스터의 모든 서버 인스턴스에서 볼 수 있기 때문에 한 번만 추가하면 됩니다. ``DataSource``를 그룹의 단일 노드를 가리키도록 변경하십시오.

Aurora 복제 통계에 대한 자세한 내용은 AWS Aurora 문서 를 참조하십시오.
예시:
{
  "SqlSettings": {
      "ReplicaLagSettings": [
        {
            "DataSource": "replica-1",
            "QueryAbsoluteLag": "select server_id, highest_lsn_rcvd-durable_lsn as bindiff from aurora_global_db_instance_status() where server_id=<>",
            "QueryTimeLag": "select server_id, visibility_lag_in_msec from aurora_global_db_instance_status() where server_id=<>"
        }
      ]
  }
}
아래 강조된 구성을 SqlSettings.ReplicaLagSettings 배열에 추가하십시오. 모든 노드에 대한 복제 통계는 MySQL 복제 그룹의 모든 서버 인스턴스 간에 공유되므로 한 번만 추가하면 됩니다. DataSource 를 그룹의 단일 노드를 가리키도록 변경하십시오.

그룹 복제 통계에 대한 자세한 내용은 MySQL 문서 를 참조하십시오.
예시:
{
  "SqlSettings": {
      "ReplicaLagSettings": [
        {
            "DataSource": "replica-1",
            "QueryAbsoluteLag": "select member_id, count_transactions_remote_in_applier_queue FROM performance_schema.replication_group_member_stats where member_id=<>",
            "QueryTimeLag": ""
        }
      ]
  }
}
아래 강조된 구성을 SqlSettings.ReplicaLagSettings 배열에 추가하십시오. 이 쿼리는 클러스터의 기본 노드에서 실행되어야 합니다. 이를 위해 DataSource 를 구성한 SqlSettings.DataSource 설정과 일치하도록 변경하십시오.
pg_stat_replication에 대한 자세한 내용은 PostgreSQL 문서 를 참조하십시오.

예시:
{
  "SqlSettings": {
      "ReplicaLagSettings": [
        {
            "DataSource": "postgres://mmuser:password@localhost:5432/mattermost_test?sslmode=disable&connect_timeout=10.",
            "QueryAbsoluteLag": "select usename, pg_wal_lsn_diff(pg_current_wal_lsn(),replay_lsn) as metric from pg_stat_replication;",
            "QueryTimeLag": ""
        }
      ]
  }
}
데이터베이스 사용자에게 pg_monitor 권한을 부여하십시오. 이 사용자는 위의 DataSource 문자열에서 구성한 것과 동일해야 합니다.
역할에 대한 자세한 내용은 PostgreSQL 문서 를 참조하십시오.
sudo -u postgres psql
postgres=# GRANT pg_monitor TO mmuser;

설정을 저장하고 모든 Mattermost 노드를 다시 시작합니다.
Grafana 모니터링 Mattermost 인스턴스로 이동하여 Mattermost Performance Monitoring v2 대시보드를 엽니다.
QueryTimeLag 차트는 이미 존재하는 Replica Lag 차트를 활용하여 설정되어 있습니다. QueryAbsoluteLag 지표를 사용하는 경우 Replica Lag 차트를 복제하고 쿼리를 아래의 절대 지연 메트릭을 사용하도록 수정하고 제목을 Replica Lag Absolute로 변경하십시오.
mattermost_db_replica_lag_abs{instance=~"$server"}

복제 모니터 간격(초)

모든 플랜 에서 사용 가능

self-hosted 배포판

비정상적인 복제본을 얼마나 자주 확인할지 지정합니다. Mattermost는 해당 복제본이 살아있는 경우 동적으로 해당 복제본을 선택합니다.

숫자 입력. 기본값은 5초입니다.

시스템 구성 경로: N/A
config.json 설정: ".SqlSettings.Replic aMonitorIntervalSeconds": 5
환경 변수: MM_SQLSETTINGS_ REPLICAMONITORINTERVALSECONDS

Elasticsearch

Enterprise 플랜에서 사용 가능

self-hosted 배포판

Elasticsearch은 엔터프라이즈 규모의 배포를 제공하며 최적화된 검색 성능을 제공하고 성능 저하와 타임아웃을 방지합니다. 자세한 내용은 당사의 제품 설명서에서 Elasticsearch 를 확인하세요.

시스템 콘솔 > 환경 > Elasticsearch 에서 Mattermost가 배포된 Elasticsearch 환경을 구성할 수 있습니다. 또한 다음 표에 설명된대로 config.json 파일을 편집할 수 있습니다. 이 섹션의 구성 설정을 변경하려면 적용되기 전에 서버를 재시작해야 합니다.

Elasticsearch 인덱싱 활성화

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

새 게시물을 자동으로 색인하도록 Mattermost를 구성합니다.

true: 새 게시물의 색인이 자동으로 수행됩니다.
false: (기본값) Elasticsearch 색인이 비활성화되며, 새 게시물이 색인되지 않습니다.

시스템 구성 경로: 환경 > Elasticsearch
config.json 설정: ".Elasticsearchsettings.EnableIndexing: false",
환경 변수: MM_ELASTICSEARCHSETTINGS_ENABLEINDEXING

참고 사항:

색인이 비활성화되고 색인이 생성된 후 다시 활성화되면, 완전한 검색 결과를 보장하기 위해 인덱스를 정리하고 다시 작성하는 것이 좋습니다.
Elasticsearch를 검색 쿼리에 사용하기 전까지는 데이터베이스 검색이 사용됩니다.

서버 연결 주소

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Elasticsearch 서버의 주소입니다.

시스템 구성 경로: 환경 > Elasticsearch
config.json 설정: ".Elasticsearch settings.ConnectionUrl",
환경 변수: MM_ELASTICSEAR CHSETTINGS_CONNECTIONURL

CA 경로

Elasticsearch 서버의 사용자 정의 인증서 기관 인증서의 선택적인 경로입니다.	시스템 구성 경로: 환경 > Elasticsearch `config.json` 설정: `".Elasticsearchsettings.CA",` 환경 변수: `MM_ELASTICSEARCHSETTINGS_CA`
참고 : Mattermost v7.8부터 사용 가능합니다. 기본 인증서 기관 인증서를 사용하려면 이 설정을 비워두십시오.

클라이언트 인증서 경로

Elasticsearch 서버에 대한 PEM 형식의 선택적인 클라이언트 인증서입니다.	시스템 구성 경로: 환경 > Elasticsearch `config.json` 설정: `".Elasticsearchsetti ngs.ClientCert",` 환경 변수: `MM_ELASTICSE ARCHSETTINGS_CLIENTCERT`
참고 : Mattermost v7.8부터 사용 가능합니다. 기본 기본 인증 자격 증명과 함께 사용하거나 대체하는 데 사용할 수 있습니다.

클라이언트 인증서 키 경로

PEM 형식의 클라이언트 인증서의 선택적인 키입니다.

시스템 구성 경로: 환경 > Elasticsearch
config.json 설정: ".Elasticsear chsettings.ClientKey",
환경 변수:

MM_ELASTICSEARCHSETTINGS_CLIENTKEY

참고 : Mattermost v7.8부터 사용 가능합니다. 기본 기본 인증 자격 증명과 함께 사용하거나 대체하는 데 사용할 수 있습니다.

TLS 인증 확인 건너뛰기

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

TLS 연결에 대한 인증 단계를 건너뛸 수 있습니다.

true : TLS 연결에 대한 인증 단계를 건너뜁니다.
false : (기본값) Mattermost는 인증 확인을 건너뛸 수 없습니다.

시스템 구성 경로: 환경 > Elasticsearch
config.json 설정: ".Elasticsearchsettings.SkipTLSV erification: false",
환경 변수: MM_ELASTICSEARCHSET TINGS_SKIPTLSVERIFICATION

서버 사용자 이름

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

(Optional) Elasticsearch 서버에 인증하기 위한 사용자 이름입니다.

문자열 입력.

시스템 구성 경로: 환경 > Elasticsearch
config.json 설정: ".Elastic searchsettings.UserName",
환경 변수: MM_ELASTICSEARCHSETTIN GS_USERNAME

서버 비밀번호

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

(Optional) Elasticsearch 서버에 인증하기 위한 비밀번호입니다.

문자열 입력.

시스템 구성 경로: 환경 > Elasticsearch
config.json 설정: ".Elasticsearch settings.Password",
환경 변수: MM_ELASTICSEARC HSETTINGS_PASSWORD

클러스터 스니핑 활성화

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Mattermost를 구성하여 클러스터의 모든 데이터 노드를 자동으로 찾아 연결하도록 합니다.

true : 스니핑은 클러스터의 모든 데이터 노드를 자동으로 찾아 연결합니다.
false : (기본값) 클러스터 스니핑이 비활성화됩니다.

시스템 구성 경로: 환경 > Elasticsearch
config.json 설정: ".Elasticsearchset tings.Sniff: false",
환경 변수:

MM_ELASTICSEARCHSETTINGS_SNIFF

시스템 콘솔에서 연결 테스트 버튼을 선택하여 Mattermost와 Elasticsearch 서버 간의 연결을 확인합니다.

대량 색인

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Mattermost를 구성하여 데이터베이스에 있는 모든 기존 글을 대량 색인하도록 합니다.	시스템 구성 경로: 환경 > Elasticsearch `config.json` 설정: N/A 환경 변수: N/A
시스템 콘솔에서 지금 색인 버튼을 선택하여 모든 글을 대량 색인 시작합니다. 색인 프로세스가 취소되면 색인 및 검색 결과가 불완전해집니다.

색인 정리 중 무시할 색인 이름을 지정합니다.

색인 정리 중 무시할 색인 이름을 지정합니다. 쉼표로 여러 개의 색인 이름을 구분합니다.

별표(*)를 사용하여 일련의 색인 이름을 일치시킬 수 있습니다.

시스템 구성 경로: 환경 > Elasticsearch
config.json 설정: ElasticsearchSettings.IgnoredPurgeIndexes
환경 변수: MM_ELASTICSEARCHSETTINGS_IGNOREDPURGEINDEXES

색인 정리

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

전체 Elasticsearch 색인을 정리합니다. 일반적으로 색인이 손상되었거나 검색이 예상대로 작동하지 않을 때 사용됩니다.	시스템 구성 경로: 환경 > Elasticsearch `config.json` 설정: 없음 환경 변수: 없음
색인을 정리하려면 시스템 콘솔에서 색인 정리 버튼을 선택하십시오. 색인을 정리한 후, 지금 색인 버튼을 선택하여 새 색인을 만듭니다.

검색 쿼리에 대한 Elasticsearch 활성화

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

최신 색인을 사용하여 모든 검색 쿼리에 대해 Elasticsearch를 사용하도록 Mattermost를 구성합니다.

true: 최신 색인을 사용하여 모든 검색 쿼리에 대해 Elasticsearch가 사용됩니다. 기존 게시 데이터베이스의 대량 색인이완료될 때까지 검색 결과가 불완전할 수 있습니다.
false: (기본값) 검색 쿼리에는 데이터베이스 검색이 사용됩니다.

시스템 구성 경로: 환경 > Elasticsearch
config.json 설정: “.Elasticsearchsettings.EnableSearching: false”,
환경 변수: MM_ELASTICSEARCHSETTINGS_ENABLESEARCHING

자동완성 쿼리에 대한 Elasticsearch 활성화

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

최신 색인을 사용하여 사용자 및 채널에 대한 모든 자동완성 쿼리에 대해 Elasticsearch를 사용하도록 Mattermost를 구성합니다.

true: 최신 색인을 사용하여 사용자 및 채널에 대한 모든 자동완성 쿼리에 대해 Elasticsearch가 사용됩니다.
false: (기본값) 데이터베이스 자동완성이 사용됩니다.

시스템 구성 경로: 환경 > Elasticsearch
config.json 설정: ".Elasticsearchsettings.EnableAutocomplete: false",
환경 변수: MM_ELASTICSEARCHSETTINGS_ENABLEAUTOCOMPLETE

참고: 자동완성 결과는 기존 사용자 및 채널 데이터베이스의 대량 색인이 완료될 때까지 불완전할 수 있습니다.

게시물 색인 복제본

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

각 게시물 색인에 사용할 복제본 수입니다.

숫자 입력. 기본값은 1 입니다.

시스템 구성 경로: 없음
config.json 설정: ".Elasticsearchsettings.PostIndexReplicas: 1",
환경 변수: MM_ELASTICSEARCHSETTINGS_POSTINDEXREPLICAS

중요 사항: 이 설정을 변경하면 변경된 구성이 새로 생성된 색인에만 적용됩니다. 기존 색인에 변경을 적용하려면 이 설정을 변경한 후 색인을 정리하고 다시 작성해야 합니다.

게시물 색인 샤드

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

각 게시물 색인에 사용할 샤드 수입니다.

숫자 입력. 기본값은 1 입니다.

시스템 구성 경로: 없음
config.json 설정: ".Elasticsearchsettings.PostIndexShards: 1",
환경 변수: MM_ELASTICSEARCHSETTINGS_POSTINDEXSHARDS

채널 색인 복제본

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

각 채널 색인에 사용할 복제본 수입니다.

숫자 입력. 기본값은 1입니다.

시스템 구성 경로: 없음
config.json 설정: “.Elasticsearchsettings.ChannelIndexReplicas: 1”,
환경 변수: MM_ELASTICSEARCHSETTINGS_CHANNELINDEXREPLICAS

채널 색인 샤드

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

각 채널 색인에 사용할 샤드 수입니다.

숫자 입력. 기본값은 1 입니다.

시스템 구성 경로: 없음
config.json 설정: ".Elasticsearchsettings.ChannelIndexShards: 1",
환경 변수: MM_ELASTICSEARCHSETTINGS_CHANNELINDEXSHARDS

사용자 색인 복제본

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

각 사용자 색인에 사용할 복제본 수입니다.

숫자 입력. 기본값은 1 입니다.

시스템 구성 경로: 없음
config.json 설정: ".Elasticsearchsettings.UserIndexReplicas: 1",
환경 변수: MM_ELASTICSEARCHSETTINGS_USERINDEXREPLICAS

사용자 색인 샤드

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

각 사용자 색인에 사용할 샤드 수입니다.

숫자 입력. 기본값은 1 입니다.

시스템 구성 경로: 없음
config.json 설정: ".Elasticsearchsettings.UserIndexShards: 1",
환경 변수: MM_ELASTICSEARCHSETTINGS_USERINDEXSHARDS

검색 인덱스 집계

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

이 설정에서 지정한 일(day) 단위로 Elasticsearch 인덱스(index)가 집계되는 나이 이전의 Elasticsearch 인덱스(index)입니다.

숫자 입력. 기본값은 365 일입니다.

시스템 구성 경로: N/A
config.json 설정: ".Elasticsearchsetings.Aggreg atePostsAfterDays: 365",
환경 변수: MM_ELASTICSEARCHSETTIN GS_AGGREGATEPOSTSAFTERDAYS

참고 : 데이터 보존 정책 및 Elasticsearch 을 사용하는 경우, 데이터 보존 정책보다 큰 값을 설정하세요.

게시물 집계기 시작 시간

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

일일 예약된 집계기 작업의 시작 시간입니다.

서버의 지역 시간을 기준으로 된 24시간 형식의 기준 시간이어야 합니다. HH:MM

기본값은 03:00 (오전 3시)입니다.

시스템 구성 경로: N/A
config.json 설정: ".Elasticsearchsettings.Posts AggregatorJobStartTime: 03:00",
환경 변수: MM_ELASTICSEARCHSETTI NGS_POSTSAGGREGATORJOBSTARTTIME

인덱스 접두어

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

추가되는 Elasticsearch 인덱스(index) 이름 앞에 붙는 접두어입니다.	시스템 구성 경로: N/A `config.json` 설정: `".Elasticsear chsettings.IndexPrefix",` 환경 변수: `MM_ELASTICS EARCHSETTINGS_INDEXPREFIX`
참고 : 이 설정을 사용하는 경우, Mattermost가 생성하는 모든 Elasticsearch 인덱스(index)에는 이 접두어가 붙습니다. 인덱스 이름이 충돌하지 않도록 서로 다른 접두사를 설정할 수 있습니다.

실시간 인덱싱 일괄 처리 크기

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Elasticsearch 인덱스(index)에 추가되기 전에 필요한 새로운 게시물의 수입니다. 인덱싱 후, 게시물은 검색 가능해집니다.

초당 1개 이상의 게시물이 있는 서버에서는 이 값을 20초 동안의 평균 게시물 수로 설정하는 것이 좋습니다.

숫자 입력. 기본값은 1 입니다. 게시물은 생성될 때 동기적으로 인덱싱됩니다.

시스템 구성 경로: N/A
config.json 설정: ".Elasticsearchsettings.LiveI ndexingBatchSize: 1",
환경 변수: MM_ELASTICSEARCHSETTIN GS_LIVEINDEXINGBATCHSIZE

참고 : 초당 1개 이상의 게시물을 처리하는 설치에서는 일괄 처리 크기를 증가시켜 Elasticsearch 클러스터의 속도 제한 또는 리소스 제한을 피하기 위해 이 값을 더 높게 설정해야 할 수 있습니다.

이 값을 높이면 정확히 어떤 일이 벌어집니까? 주요 영향은 게시물이 일정 수의 게시물을 만나 Elasticsearch에 인덱싱되어 Mattermost에서 검색 가능해지게 되는 것입니다. 따라서 더 큰 서버용으로 이 설정을 기준으로 해 놓고 게시물을 작성하면, 평균적으로 약 10-20초 동안 검색에서는 해당 게시물을 찾을 수 없게 됩니다. 현실적으로, 이렇게 빨리 게시물을 검색하는 사용자의 한정된 수로 인해 사용자들은 이러한 영향을 보거나 느끼지 못할 것입니다. Elasticsearch 서버 사양에 따라 이 값을 낮은 평균값 또는 높은 평균값으로 설정할 수도 있습니다.

서버가 바쁜 시간에는 이 지연 시간이 더 빨라지므로 더 많은 트래픽이 발생하면 인덱스 수가 빨라지게 됩니다. 반면, 느린 시간에는 그 반대가 예상됩니다.

서버에 적합한 적절한 숫자를 찾는 방법

서버가 매 분마다 생성하는 게시물 수를 파악해야 합니다. 아래 쿼리를 실행하여 서버의 평균 분당 게시물 수를 계산하세요.
이 쿼리는 무거울 수 있으므로 최대 트래픽 시간이 아닌 시간에 실행하는 것이 좋습니다. 추가로, WHERE 절을 조정하여 다른 시간 기간 동안의 분당 게시물 수를 확인할 수 있습니다. 현재 31536000000 은 1년의 밀리초 수를 나타냅니다.
SELECT AVG(postsPerMinute) as averagePostsPerMinute FROM ( SELECT count(*) as postsPerMinute, date_trunc('minute', to_timestamp(createat/1000)) FROM posts WHERE createAt > ( (extract(epoch from now()) * 1000 ) - 31536000000) GROUP BY date_trunc('minute', to_timestamp(createat/1000)) ) as ppm;
환경에 적합한 색인 창을 결정하고, 그에 따라 평균 분당 게시물 수를 나누세요. 일반적으로 10-20초를 권장합니다. 평균적으로 매 분에 600 개의 게시물이 있고, 20초마다 색인하려면 (60초 / 20초 = 3`) 600 / 3 을 계산하여 200 을 얻을 수 있습니다. 200개의 게시물 이후에 Mattermost가 Elasticsearch에 게시물을 색인합니다. 따라서 검색 가능성에는 평균적으로 20초의 지연이 발생합니다.
config.json 을 수정하거나 mmctl을 실행하여 LiveIndexingBatchSize 설정을 수정하세요.
config.json에서
{ "ElasticsearchSettings": { "LiveIndexingBatchSize": 200 } }
mmctl을 통해
mmctl config set ElasticsearchSettings.LiveIndexingBatchSize 200
환경 변수를 통해
Mattermost 서버를 다시 시작하세요.

Bulk indexing time window

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

대량 인덱서가 색인하는 게시물 배치의 최대 시간 창(초)입니다. 이 설정은 데이터베이스에 약 1000만 개 이상의 게시물이 있는 설치 에서 성능 최적화를 위한 것입니다.

초 단위의 숫자 입력. 기본값은 3600초 (1시간)입니다. (평균적으로 하루에 2,000개의 게시물이 데이터베이스에 추가되는 경우에 대한 평균 초 값을 기준으로 근사값을 계산하세요.)

시스템 구성 경로: 환경 > Elasticsearch
config.json 설정: “.Elasticsearchsettings.BulkIndexingTimeWindowSeconds: 3600”,
환경 변수: MM_ELASTICSEARCHSETTINGS_BULKINDEXINGTIMEWINDOWSECONDS

참고: 이 값을 너무 낮게 설정하면 대량 색인 작업이 느리게 실행될 수 있습니다.

Request timeout

Elasticsearch 호출의 타임아웃(초)입니다.

초 단위의 숫자 입력. 기본값은 30초입니다.

시스템 구성 경로: N/A
config.json 설정: “.Elasticsearchsettings.RequestTimeoutSeconds: 30”,
환경 변수: MM_ELASTICSEARCHSETTINGS_REQUESTTIMEOUTSECONDS

Trace

이전 기업용 버전 E10/E20에서 사용 가능

파일 저장소

모든 플랜 에서 사용 가능

self-hosted 배포판

‘System Console > Environment > File Storage’ 로 이동하여 또는 다음 표에 설명된대로 config.json 파일을 편집하여 파일 저장 설정을 구성합니다.

Mattermost Academy Learn about file storage

Note

Mattermost는 현재 로컬 파일 시스템 및 Amazon S3 또는 호환되는 S3에 파일을 저장하는 것을 지원합니다. Mattermost는 MinIO 및 Digital Ocean Spaces 제품과 테스트되었으나 시장에서 모든 호환되는 S3 컨테이너를 테스트한 것은 아닙니다. 기타 호환되는 S3 컨테이너를 사용하려면 직접 테스트를 완료하는 것을 권장합니다.

파일 저장 시스템

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

사용되는 파일 저장 시스템의 유형입니다. 로컬 파일 시스템 또는 Amazon S3일 수 있습니다.

local : (기본값) 파일 및 이미지는 지정된 로컬 파일 디렉터리에 저장됩니다.
amazons3 : 제공된 액세스 키, 버킷 및 지역 필드에 기반하여 파일 및 이미지가 Amazon S3에 저장됩니다. 이 드라이버는 MinIO (베타) 및 Digital Ocean Spaces와 호환됩니다.

시스템 구성 경로: 환경 > 파일 저장
config.json 설정: ".FileSettin gs.DriverName: local”,
환경 변수: MM_FILESETTINGS_DRIVERNAME

로컬 저장소 디렉터리

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

파일 저장 시스템 이 로컬 로 설정된 경우 파일이 쓰여지는 로컬 디렉터리입니다. Mattermost가 실행 중인 사용자가 쓰기 가능한 어떤 디렉터리든 관계없으며 Mattermost가 설치된 디렉터리를 기준으로 상대적입니다.

기본값은 .data 입니다.

시스템 구성 경로: 환경 > 파일 저장
config.json 설정: ".FileSettings.Directory”,
환경 변수: MM_FILESETTINGS_DIRECTORY

참고 : 파일 저장 시스템 이 amazons3 로 설정된 경우, 이 설정은 영향을 미치지 않습니다.

최대 파일 크기

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

메시지 첨부 파일의 최대 파일 크기입니다. 이 값은 시스템 콘솔에서 메가바이트로 지정해야 하며 config.json 파일에서는 바이트로 지정해야 합니다.

기본값은 104857600 바이트 ( 1 메가바이트)입니다.

시스템 구성 경로: 환경 > 파일 저장
config.json 설정: ".FileSettings .MaxFileSize: 104857600",
환경 변수: MM_FILESETTINGS_MAXFILESIZE

경고 : 서버 메모리가 설정 선택을 지원할 수 있는지 확인하세요. 대용량 파일 크기는 서버 충돌 및 네트워크 중단으로 인한 업로드 실패 위험을 증가시킵니다.

참고 : Mattermost 앞에 프록시 또는 로드 밸런서를 사용하는 경우 다음 프록시 설정을 해당되는 대로 조정해야 합니다:

NGINX의 경우,

client_max_body_size를
사용하세요.

Apache의 경우, LimitRequestBody를 사용하세요.

컨텐츠별 문서 검색 활성화

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

사용자들이 메시지에 첨부된 문서의 내용을 검색할 수 있도록 활성화합니다.

true : (기본값) 문서의 내용으로 검색할 수 있습니다.
false : 문서의 내용으로 검색할 수 없습니다. 문서 내용 검색이 비활성화된 경우 사용자는 파일 이름으로만 파일을 검색할 수 있습니다.

시스템 구성 경로: 환경 > 파일 저장
config.json 설정: ".FileSetting s.ExtractContent: true",
환경 변수: MM_FILESETTINGS_EXTRACTCONTENT

참고 : Mattermost Server v5.35로 업그레이드하기 전에 메시지로 공유된 파일에 대한 문서 내용 검색 결과가 부족할 수 있으며, mmctl 을 사용하여 추출 명령을 실행하기 전까지 완전하지 않을 수 있습니다. 이 명령을 실행하지 않으면 사용자는 이전 파일을 파일 이름을 기반으로 검색할 수 있습니다.

PDF, DOCX 및 ODT 이외의 파일 형식(PDF, DOCX 및 ODT 포함)을 Mattermost에서 내용 검색 지원을 확장하려면 다음 의존 성 을 선택적으로 설치할 수 있습니다:

tidy : HTML 문서의 내용을 검색하는 데 사용됩니다.
wv : DOC 문서의 내용을 검색하는 데 사용됩니다.
popplerutils : PDF 문서의 내용을 추출할 때 서버 성능을 크게 향상시키는 데 사용됩니다.
unrtf : RTF 문서의 내용을 검색하는 데 사용됩니다.
JusText : HTML 문서의 내용을 검색하는 데 사용됩니다.

이러한 의존성을 설치하지 않을 경우, 추출할 수 없는 문서에 대한 로그 항목이 표시됩니다. 추출할 수 없는 문서는 건너뛰고 내용 추출이 진행됩니다.

압축된 파일 안 문서 내용 검색 활성화

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

메시지에 첨부된 압축된 ZIP 파일의 내용을 검색할 수 있게 합니다.

true : ZIP 파일 내 문서의 내용이 검색 결과에 반환됩니다. 큰 파일의 경우 서버 성능에 영향을 미칠 수 있습니다.
false : (기본값) ZIP 파일 내 문서의 내용이 검색 결과에 반환되지 않습니다.

시스템 구성 경로: 환경 > 파일 저장
config.json 설정: ".FileSettings. ArchiveRecursion: false",
환경 변수:

MM_FILESETTINGS_ARCHIVERECURSION

참고 : ZIP 파일 내 문서 내용 검색은 모바일 지원이 곧 제공됩니다. 문서 내용 검색은 서버에 부하를 추가합니다. 대규모 배포나 많은 대용량 텍스트 문서를 공유하는 팀의 경우, 프로덕션 환경에서 활성화하기 전에 스테이징 환경에서 이 기능을 활성화하고 하드웨어 요구 사항을 검토하는 것을 권장합니다. 하드웨어 요구 사항 을 확인하고 테스트해 주세요.

Amazon S3 버킷

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

S3 호환 객체 저장소 인스턴스의 버킷 이름입니다.

S3 호환 버킷 이름을 포함하는 문자열입니다.

시스템 구성 경로: 환경 > 파일 저장
config.json 설정:

".FileSettings.AmazonS3Bucket", - 환경 변수:

MM_FILESETTINGS_AMAZONS3BUCKET

Amazon S3 경로 접두어

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Amazon S3 버킷 에서 선택한 접두어입니다.

경로 접두어를 포함하는 문자열입니다.

시스템 구성 경로: N/A
config.json 설정: ".FileSetti ngs.AmazonS3PathPrefix",
환경 변수: MM_FILESETT INGS_AMAZONS3PATHPREFIX

Amazon S3 지역

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

AWS에서 Amazon S3 버킷 을 생성할 때 선택한 지역입니다.

버킷을 포함하는 AWS 지역을 나타내는 문자열입니다. 지역이 설정되지 않으면 Mattermost는 적절한 지역을 AWS에서 가져오려 시도하고 발견하지 못할 경우 us-east-1 로 설정합니다.

시스템 구성 경로: 환경 > 파일 저장
config.json 설정: :literal:

".FileSettings.AmazonS3Region", - 환경 변수:

MM_FILESETTINGS_AMAZONS3REGION

참고 : MinIO 또는 Digital Ocean Spaces의 경우, 이 설정을 비워 두세요.

Amazon S3 액세스 키 ID

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

S3 호환 저장소 인스턴스의 액세스 키를 나타내는 문자열입니다. EC2 관리자가 액세스 키 ID를 제공할 수 있습니다.	시스템 구성 경로: 환경 > 파일 저장 `config.json` 설정: `".FileSettings. AmazonS3AccessKeyId",` 환경 변수: `MM_FILESETTI NGS_AMAZONS3ACCESSKEYID`
참고 : Amazon S3 IAM 역할 또는 Amazon S3와 함께 스위치 역할을 사용하는 경우 를 제외하고 액세스에는 이것이 필요합니다.

Amazon S3 엔드포인트

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

S3 호환 인스턴스의 호스트 이름입니다.

S3 호환 스토리지 인스턴스의 호스트 이름을 나타내는 문자열입니다. 기본값은 s3.amazonaws.com 입니다.

참고 : Digital Ocean Spaces의 경우, 호스트 이름을 <region>.digitaloceanspaces.com 으로 설정해야 합니다. 여기서 <region> 은 Space 설정 시 선택한 지역의 약어입니다. nyc3 , ams3 , 또는 sgp1 일 수 있습니다.

Amazon S3 시크릿 액세스 키

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Your Amazon S3 Access Key ID와 연결된 시크릿 액세스 키입니다.

S3 호환 스토리지 인스턴스의 시크릿 액세스 키를 나타내는 문자열입니다.

시스템 구성 경로: 환경 > 파일 저장
config.json 설정: ".FileSettings.Amaz onS3SecretAccessKey",
환경 변수: MM_FILESETTINGS_ AMAZONS3SECRETACCESSKEY

안전한 Amazon S3 연결 활성화

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Amazon S3 연결을 안전하게 활성화하거나 비활성화합니다.

true : (기본값) 안전한 Amazon S3 연결만 가능합니다.
false : Amazon S3와의 안전하지 않은 연결을 허용합니다.

시스템 구성 경로: 환경 > 파일 저장
config.json 설정: ".FileSettings.Ama zonS3SSL: true",
환경 변수: MM_FILESETTINGS_AMAZONS3SSL

Amazon S3 서명 v2

이전 엔터프라이즈 에디션 E10/E20에서 사용 불가

Mattermost는 기본적으로 AWS에 대한 API 호출에 Signature v4를 사용하지만, 특정 상황에서는 v2가 필요할 수 있습니다.

true : 서명 v2 서명 프로세스를 사용합니다.
false : (기본값) 서명 v4 서명 프로세스를 사용합니다.

시스템 구성 경로: 해당 없음
config.json 설정: ".FileSettings.Amazo nS3SignV2: false",
환경 변수:

MM_FILESETTINGS_AMAZONS3SIGNV2

Amazon S3 서명 v2 서명 프로세스를 사용해야 하는 경우에 대한 자세한 정보는 AWS 문서 를 참조하십시오.

Amazon S3를 위한 서버 측 암호화 활성화

이전 엔터프라이즈 에디션 E20에서 사용 가능

Amazon S3를 위한 서버 측 암호화를 활성화하거나 비활성화합니다.

true : Amazon S3의 파일을 Amazon S3 관리 키를 사용하여 서버 측 암호화합니다.
false : (기본값) Amazon S3의 파일을 암호화하지 않습니다.

시스템 구성 경로: 환경 > 파일 저장
config.json 설정: ".FileSettings. AmazonS3SSE: false",
환경 변수: MM_FILESETTINGS_AMAZONS3SSE

Amazon S3 디버깅 활성화

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Amazon S3 디버깅을 활성화하거나 비활성화하여 시스템 로그에서 추가 디버깅 정보를 캡처합니다.

true : 시스템 로그에 추가 디버깅 정보가 기록됩니다.
false : (기본값) 시스템 로그에 Amazon S3 디버깅 정보가 포함되지 않습니다. 일반적으로 운영 환경에서는 false 로 설정합니다.

시스템 구성 경로: 환경 > 파일 저장
config.json 설정: ".FileSettings.Ama zonS3Trace: false",
환경 변수:

MM_FILESETTINGS_AMAZONS3TRACE

시스템 콘솔에서 연결 테스트 버튼을 선택하여 설정을 유효성 검사하고 사용자가 서버에 액세스할 수 있는지 확인합니다.

이니셜 글꼴

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

자동 생성된 프로필 사진에서 사용되는 글꼴로, 색상 배경과 사용자 이니셜이 있습니다.

글꼴 파일 이름을 포함한 문자열입니다. 기본값은 nunito-bold.ttf 입니다.

시스템 설정 경로: N/A
config.json 설정: ".FileSettings.InitialFo nt: nunito-bold.ttf",
환경 변수: MM_FILESETTINGS_INITIALFONT

아마존 S3 요청 시간 초과

아마존 S3 저장소로의 요청이 타임아웃되기 전의 밀리초 단위 시간입니다.

기본값은 30000 (30초)입니다.

시스템 설정 경로: N/A
config.json 설정: ".FileSettings.AmazonS3RequestT imeoutMilliseconds: 30000
환경 변수: MM_FILESETTINGS_AMAZONS 3REQUESTTIMEOUTMILLISECONDS

이미지 프록시

모든 플랜 에서 사용 가능

self-hosted 배포판

이 메시지는 Mattermost 앱이 원격 자체 호스팅된 서버에 직접 연결하는 것을 방지하기 위해 이미지 프록시가 사용된다는 내용입니다. 이미지 프록시를 구성하려면 System Console > Environment > Image Proxy로 이동하거나 다음 표에 설명된 대로 config.json 파일을 편집하세요.

이미지 프록시 사용

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

이미지 프록시는 Mattermost 앱 연결을 익명화하고 보안되지 않은 콘텐츠에 액세스하는 것을 방지합니다.

true : (기본값) 외부 이미지를 불러오기 위해 이미지 프록시를 활성화합니다.
false : 이미지 프록시를 비활성화합니다.

시스템 구성 경로: Environment > Image Proxy
config.json 설정: ".ImageProxySett ings.Enable": true",
환경 변수:

MM_IMAGEPROXYSETTINGS_ENABLE

이미지 프록시 설명서에서 자세히 알아보세요.

이미지 프록시 유형

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Mattermost가 사용하는 이미지 프록시의 유형입니다.

local : (기본값) Mattermost 서버 자체가 이미지 프록시로 작동합니다.
atmos/camo : 외부 atmos/camo 이미지 프록시가 사용됩니다.

시스템 구성 경로: Environment > Image Proxy
config.json 설정: ".ImageProxySettings.ImagePro xyType": "local",
환경 변수: MM_IMAGEPROX YSETTINGS_IMAGEPROXYTYPE

이미지 프록시 설명서에서 자세히 알아보세요.

원격 이미지 프록시 URL

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

atmos/camo 프록시의 URL입니다. local 이미지 프록시를 사용할 때는 이 설정이 필요하지 않습니다.

시스템 구성 경로: Environment > Image Proxy
config.json 설정: ".ImageProxySettings. RemoteImageProxyURL",
환경 변수: MM_IMAGEPROXYSETTINGS_RE MOTEIMAGEPROXYURL

원격 이미지 프록시 옵션

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

atmos/camo 이미지 프록시에 전달되는 URL 서명 키입니다. local 이미지 프록시 유형을 사용할 때는 이 설정이 필요하지 않습니다.	시스템 구성 경로: Environment > Image Proxy `config.json 설정`: `".ImageProxySettings. RemoteImageProxyOptions",` 환경 변수: `MM_IMAGEPROXYSETTINGS_REM OTEIMAGEPROXYOPTIONS`
이미지 프록시 설명서에서 자세히 알아보세요.

SMTP

모든 플랜 에서 사용 가능

self-hosted 배포판

Environment > SMTP 로 이동하여 시스템 콘솔 > 환경 > SMTP 를 편집하거나, 다음 표에 설명된 대로 config.json 파일을 수정하여 SMTP 이메일 서버 설정을 구성하세요.

SMTP 서버

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

이메일 알림에 사용되는 SMTP 이메일 서버의 위치입니다.

System Config 경로: 환경 > SMTP
config.json 설정:

".EmailSettings.SMTPServer", - 환경 변수:

MM_EMAILSETTINGS_SMTPSERVER

SMTP 서버 포트

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

SMTP 이메일 서버의 포트입니다.

숫자 입력.

System Config 경로: 환경 > SMTP
config.json 설정:

".EmailSettings.SMTPPort",

환경 변수: MM_EMAILSETTINGS_SMTPPORT

SMTP 인증 활성화

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

SMTP 인증을 활성화하거나 비활성화합니다.

true : SMTP 사용자 이름과 암호를 사용하여 SMTP 서버에 인증합니다.
false : (기본값) Mattermost는 SMTP 서버에 인증을 시도하지 않습니다.

System Config 경로: 환경 > SMTP
config.json 설정: ".EmailSettings.Enab leSMTPAuth": false",
환경 변수:

MM_EMAILSETTINGS_ENABLESMTPAUTH

SMTP 서버 사용자 이름

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

SMTP 서버에 인증하기 위한 사용자 이름입니다.

문자열 입력.

System Config 경로: 환경 > SMTP
config.json 설정: ".EmailSetti ngs.SMTPUsername",
환경 변수: MM_EMAILSETTIN GS_SMTPUSERNAME

SMTP 서버 암호

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

SMTP 사용자 이름과 연결된 암호입니다.

문자열 입력.

System Config 경로: 환경 > SMTP
config.json 설정: ".EmailSetting s.SMTPPassword",
환경 변수: MM_EMAIL SETTINGS_SMTPPASSWORD

SMTP 연결 보안

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

SMTP를 사용하여 전송되는 이메일의 연결 보안을 지정합니다.

지정되지 않음 : (기본값) 안전하지 않은 연결을 통해 이메일을 보냅니다.
TLS : Mattermost와 이메일 서버 간의 통신이 암호화됩니다.
STARTTLS : TLS를 사용하여 기존의 보안되지 않은 연결을 안전한 연결로 업그레이드하려고 시도합니다.

System Config 경로: 환경 > SMTP
config.json 설정: ".EmailSetti ngs.ConnectionSecurity",
환경 변수: MM_EMAILSETTI NGS_CONNECTIONSECURITY

서버 인증서 확인 건너뛰기

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Mattermost가 이메일 서버 인증서 확인을 건너뛸 수 있도록 구성합니다.

true : Mattermost는 이메일 서버 인증서를 확인하지 않습니다.
false : (기본값) Mattermost는 이메일 서버 인증서를 확인합니다.

System Config 경로: 환경 > SMTP
config.json 설정: ".EmailSettings.SkipServerCertif icateVerification": false",
환경 변수: MM_EMAILSETTINGS_SKIP SERVERCERTIFICATEVERIFICATION

보안 경고 활성화

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

보안 경보를 활성화 또는 비활성화합니다.

true : (기본값) 관리자가 관련 보안 수정 경보가 발표되면 이메일로 알림을 받습니다. 이메일 기능이 활성화되어야 합니다.
false : 보안 경보가 비활성화됩니다.

시스템 구성 경로: 환경 > SMTP
config.json 설정: ".EmailSettings.Enable SecurityFixAlert": true",
환경 변수: MM_EMAILSETTI NGS_ENABLESECURITYFIXALERT

자세한 내용은 Telemetry 문서를 참조하세요.

SMTP 서버 시간 초과

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Mattermost와 SMTP 서버 간에 TCP 연결을 설정하는 데 허용된 최대 시간(초)입니다.

숫자 값(초)입니다.

시스템 구성 경로: 환경 > SMTP
config.json 설정: ".EmailSettings.SMTPSe rverTimeout",
환경 변수: MM_EMAILSET TINGS_SMTPSERVERTIMEOUT

푸시 알림 서버

모든 플랜 에서 사용 가능

self-hosted 배포판

매터모스트를 구성하여 시스템 콘솔 > 환경 > 푸시 알림 서버 로 이동하거나 다음 표에 설명된 대로 config.json 파일을 편집하여 매터모스트 클라이언트로의 푸시 알림을 활성화합니다. 이 섹션의 구성 설정을 변경하려면 서버를 다시 시작해야 합니다.

푸시 알림 활성화

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

매터모스트 푸시 알림을 활성화하거나 비활성화합니다.

푸시 알림 전송 안 함 : 모바일 푸시 알림이 비활성화됩니다.
HPNS 연결 및 iOS 및 Android 앱으로 알림 보내기 위한 SLA 운영시간을 사용합니다 : (기본값) 매터모스트의 호스팅된 푸시 알림 서비스 를 사용합니다.
TPNS 연결로 iOS 및 Android 앱으로 알림을 보냅니다 : 매터모스트의 테스트 푸시 알림 서비스 를 사용합니다.
푸시 알림 서비스 위치 수동 입력 : 사용자 지정 모바일 앱을 빌드할 때, 푸시 알림 서버 필드에 해당 URL을 지정해야 합니다.

시스템 구성 경로: 환경 > 푸시 알림 서버
config.json 설정: ".EmailSettings.SendPushNotifi cations": true",
환경 변수: MM_EMAILSET TINGS_SENDPUSHNOTIFICATIONS

참고 :

매터모스트 기업, 전문가 및 클라우드 고객은 매터모스트의 SLA에 따른 호스팅된 푸시 알림 서비스(HPNS) 를 미국 및 독일을 포함한 두 곳에서 이용할 수 있습니다. 매터모스트 팀 에디션 고객은 매터모스트의 테스트 푸시 알림 서버(TPNS)를 사용할 수 있습니다.
TPNS는 사용자 고유의 서비스를 컴파일하기 전에 푸시 알림을 테스트하기 위해 제공되며, 매터모스트 클라우드 배포에는 사용할 수 없습니다. 제한 사항 을 숙지하세요.
모바일 푸시 알림 및 모바일 앱 문서를 검토하여 사용자 고유의 모바일 앱 및 MPNS를 컴파일하는 지침을 배포하기 전에 알아보세요.
푸시 알림이 작동하는지 확인하려면 App Store에서 사용할 수 있는 Mattermost iOS App 이나 Google Play에서 사용할 수 있는 Mattermost Android App 에 연결하세요.

푸시 알림 서버 위치

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

매터모스트 호스팅된 푸시 알림 서비스(HPNS) 서버의 물리적 위치입니다.

미국 또는 (기본값) 독일 중에서 선택하여 푸시 알림 서버 필드 서버 URL을 자동으로 채울 수 있습니다.

시스템 구성 경로: 환경 > 푸시 알림 서버
config.json 설정: ".EmailSettings .PushNotificationServer",
환경 변수: MM_EMAILSETT INGS_PUSHNOTIFICATIONSERVER

채널 당 최대 알림 수

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

성능을 최대화하기 위해 채널의 총 사용자 수가 @all, @here 및 @channel 에서 데스크톱, 이메일 또는 모바일 푸시 알림을 더 이상 보내지 않는 최대 수입니다.

숫자 입력. 기본값은 1000 입니다.

시스템 구성 경로: 환경 > 푸시 알림 서버
config.json 설정: ".TeamSettings.MaxNotifi cationsPerChannel: 1000",
환경 변수: MM_EMAILSETTINGS _MAXNOTIFICATIONSPERCHANNEL

참고 : 이 값을 조금씩 늘리고 성능 모니터링 지표 를 추적하여 시스템 상태를 모니터링한 후, 큰 채널에 읽기 전용 타운 스퀘어 채널과 같은 권한이 제한된 채널에서 누가 채널에 게시할 수 있는지를 제어하는 경우에만 이 값을 늘리도록 권장합니다.

고가용성

Enterprise 플랜에서 사용 가능

self-hosted 배포판

시스템 콘솔에서 시스템 콘솔 > 환경 설정 > 고가용성 으로 이동하거나, 다음 표에 설명된 대로 config.json 파일을 편집하여 Mattermost를 고가용성 환경 으로 구성할 수 있습니다. 이 섹션의 구성 설정 변경은 적용되기 전에 서버를 다시 시작해야 합니다.

Mattermost 고가용성 클러스터 배포에서 시스템 콘솔은 읽기 전용으로 설정되어 있으며, 설정은 config.json 파일을 직접 편집하여 변경할 수 있습니다. 그러나 고가용성 환경을 테스트하려면 config.json 파일에서 ClusterSettings.ReadOnlyConfig 를 false 로 설정하여 비활성화할 수 있습니다. 이렇게 하면 시스템 콘솔을 통해 적용된 변경 사항을 구성 파일에 저장할 수 있습니다.

고가용성 모드 사용

이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.

고가용성 모드를 활성화할 수 있습니다.

true : Mattermost 서버는 동일한 클러스터 이름을 가진 클러스터 내 다른 서버들과 상호 작용을 시도합니다. 이렇게 하면 시스템 콘솔을 읽기 전용 모드로 설정하여 서버들의 config.json 파일을 동기화합니다.
false : (기본값) Mattermost 고가용성 모드가 비활성화됩니다.

시스템 구성 경로: 환경 설정 > 고가용성
config.json 설정:

".ClusterSettings.Enable",

환경 변수:

MM_CLUSTERSETTINGS_ENABLE

Cluster name

이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.

고가용성 환경에서 이름으로 가입할 클러스터.

동일한 클러스터 이름을 가진 노드만 함께 가입합니다. 블루-그린 배포 또는 스테이징에서 동일한 데이터베이스를 가리키는 경우입니다.

시스템 구성 경로: 환경 > 고가용성
config.json 설정: ".ClusterSettings.ClusterName",
환경 변수: MM_CLUSTERSETTINGS_CLUSTERNAME

호스트 이름 재정의

이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.

이 서버의 호스트 이름을 재정의할 수 있습니다.

필요한 경우이 속성을 특정 IP 주소로 설정할 수 있습니다. 그러나 호스트 이름을 재정의하는 것은 권장하지 않습니다.
비워 두면 Mattermost는 운영 체제에서 호스트 이름을 가져오거나 IP 주소를 사용하려고 시도합니다.

시스템 구성 경로: 환경 > 고가용성
config.json 설정: ".ClusterSettings.OverrideHostname",
환경 변수: MM_CLUSTERSETTINGS_OVERRIDEHOSTNAME

자세한 내용은 고가용성 클러스터 문서를 참조하십시오.

IP 주소 사용

이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.

고가용성 환경에서 통신을 위해 호스트 이름 대신 IP 주소를 사용하도록 고가용성 환경을 구성할 수 있습니다.

true: (기본값) 클러스터는 지정된 IP 주소를 사용하여 통신을 시도합니다.
false: 클러스터는 호스트 이름을 사용하여 통신을 시도합니다.

시스템 구성 경로: 환경 > 고가용성
config.json 설정: ".ClusterSettings.UseIPAddress: true",
환경 변수: MM_CLUSTERSETTINGS_USEIPADDRESS

Gossip 사용

이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.

모든 클러스터 트래픽은 gossip 프로토콜을 사용합니다.

true: (기본값) 서버는 gossip 프로토콜을 통해 gossip 포트를 통해 통신을 시도합니다.
false: 서버는 스트리밍 포트를 통해 통신을 시도합니다.

시스템 구성 경로: 환경 > 고가용성
config.json 설정: ".ClusterSettings.UseExperimentalGossip: true",
환경 변수: MM_CLUSTERSETTINGS_USEEXPERIMENTALGOSSIP

참고 사항:

gossip 클러스터링은 더 이상 비활성화 할 수 없습니다.
gossip 포트 및 gossip 프로토콜은이 설정이 **false**로 설정되어 있어도 클러스터 상태를 결정하는 데 사용됩니다.

실험적인 Gossip 암호화 활성화

이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.

기본적으로 Gossip 암호화는 AES-256을 사용하며 이 값은 디자인상으로 구성할 수 없습니다.

true: (클라우드 배포의 기본값) 클러스터 내 모든 통신은 Gossip 프로토콜을 통해 암호화됩니다.
false: (자체 호스팅 배포의 기본값) Gossip 프로토콜을 통한 모든 통신은 변경되지 않은 채로 유지됩니다. 프로토콜은 암호화되지 않습니다.

시스템 설정 경로: 환경 > 고가용성
config.json 설정: ".ClusterSettings.EnableExperimentalGossipEncryption: false”,
환경 변수: MM_CLUSTERSETTINGS_ENABLEEXPERIMENTALGOSSIPENCRYPTION

참고 : 또는 시스템 테이블에서 ClusterEncryptionKey 행 값을 수동으로 설정할 수 있습니다. 키는 base64로 변환된 바이트 배열입니다. 이 값을 16, 24 또는 32 바이트 중 하나로 설정하여 각각 AES-128, AES-192 또는 AES-256을 선택합니다.

Gossip compression 활성화

이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.

이 구성을 비활성화하는 것을 권장합니다. - true : **(자체 호스팅

배포의 기본값)** 클러스터 내 모든 통신은 Gossip 프로토콜을 통해 압축 됩니다. 이 설정은 오래 된 서버와의 호환성을 유지 하기 위해 기본으로

활성화됩니다.

false : (클라우드 배포의 기본값) Gossip 프로토콜을 통한 모든 통신 은 압축되지 않은 채로 유지됩니다.

시스템 설정 경로: 환경 > 고가용성
config.json 설정: ".ClusterSettings.EnableG ossipCompression: true”,
환경 변수: MM_CLUSTERSETTIN GS_ENABLEGOSSIPCOMPRESSION

Gossip port

이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.

Gossip 프로토콜에 사용되는 포트. UDP 및 TCP 모두이 포트에서 허용되어야합니다.

숫자 입력. 기본값은 8074 입니다.

시스템 설정 경로: 환경 > 고가용성
config.json 설정: ".ClusterSett ings.GossipPort: 8074”,
환경 변수: MM_CLUSTE RSETTINGS_GOSSIPPORT

Streaming port

이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.

서버간 데이터 스트리밍에 사용되는 포트

숫자 입력. 기본값은 8075 입니다.

시스템 구성 경로: 환경 > 고가용성
config.json 설정:
".ClusterSettings .StreamingPort: 8075",
환경 변수:
MM_CLUSTERSETTINGS_STREAMINGPORT

읽기 전용 구성

이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.

true : (기본값) 시스템 콘솔에서 설정한 변경 사항이 무시됩니다.
false : 시스템 콘솔에서 설정한 변경 사항이 config.json에 기록됩니다.

System Config path: 없음
config.json setting: ".ClusterSettings.R eadOnlyConfig: true,
환경 변수: MM_CLUS TERSETTINGS_READONLYCONFIG

네트워크 인터페이스

이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.

고가용성 클러스터에서 자동 IP 감지를 하는 기기를 식별하는 IP 주소입니다.

문자열 입력.

시스템 설정 경로: 없음
config.json 설정: ".ClusterSettings.NetworkInterface: "",
환경 변수: MM_CLUSTERSETTINGS_NETWORKINTERFACE

바인드 주소

이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.

클러스터 트래픽을 특정 네트워크 장치에 바인딩하는 데 사용되는 IP 주소입니다.

문자열 입력.

시스템 설정 경로: 없음
config.json 설정: ".ClusterSettings.BindAddress: "",
환경 변수: MM_CLUSTERSETTINGS_BINDADDRESS

알림 주소

이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.

다른 노드에서 서버에 액세스하는 데 사용되는 IP 주소입니다. 클러스터 노드가 동일한 네트워크에 없고 NAT (네트워크 주소 변환) 이 포함되어 있을 때 주로 사용됩니다.

문자열 입력.

시스템 설정 경로: 없음
config.json 설정: ".ClusterSettings.AdvertiseAddress: "",
환경 변수: MM_CLUSTERSETTINGS_ADVERTISEADDRESS

고가용성을 위한 최대 idle 연결 수

이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.

클러스터 내에서 한 서버에서 다른 모든 서버로 유지 되는 최대 idle 연결 수입니다.

숫자 입력. 기본값은 100 입니다.

시스템 설정 경로: 없음
config.json 설정: ".ClusterSettings.MaxIdleConns: 100,
환경 변수: MM_CLUSTERSETTINGS_MAXIDLECONNS

Maximum idle connections per host

이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.

클러스터 내에서 한 서버에서 다른 서버로 유지되는 최대 아이들 연결 수.

숫자 입력. 기본값은 128 입니다.

시스템 구성 경로: 없음
config.json 설정: ".ClusterSettings.MaxIdleConnsPerHost: 128",
환경 변수: MM_CLUSTERSETTINGS_MAXIDLECONNSPERHOST

Idle connection timeout

이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.

클러스터 내 서버 간에 유지되는 아이들 연결을 유지하는 시간(밀리초).

숫자 입력. 기본값은 90000 입니다.

시스템 구성 경로: 없음
config.json 설정: ".ClusterSettings.IdleConnTimeoutMilliseconds: 90000",
환경 변수: MM_CLUSTERSETTINGS_IDLECONNTIMEOUTMILLISECONDS

속도 제한

모든 플랜 에서 사용 가능

self-hosted 배포판

레이트 제한은 Mattermost 서버가 너무 많은 요청으로 과부하되는 것을 방지하고, 제3자 애플리케이션 또는 악의적인 공격이 서버에 미치는 위험과 영향을 줄입니다. 시스템 콘솔 > 환경 > 레이트 제한 으로 이동하여 레이트 제한 설정을 구성하거나, 다음 표에 설명된 대로 config.json 파일을 편집합니다. 이 섹션의 구성 설정을 변경하려면 변경 사항이 적용되기 전에 서버를 다시 시작해야 합니다.

레이트 제한 활성화

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

특정 속도로 API를 제한하기 위해 레이트 제한을 활성화 또는 비활성화합니다.

true : API는 초당 최대 쿼리 횟수 구성 설정에 지정된 속도로 제한됩니다.
false : (기본값) API 액세스가 제한되지 않습니다.

시스템 구성 경로: 환경 > 레이트 제한
config.json 설정: ".RateLim itSettings.Enable: false”,
환경 변수: MM_RATELIMITSETTINGS_ENABLE

초당 최대 쿼리 횟수

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

레이트 제한이 활성화된 경우 API를 초당 몇 번의 요청으로 제한합니다.

숫자 입력입니다. 기본값은 10 입니다.

이 값은 초당 요청 수를 늘리려면 더 많은 요청을 허용하도록 하거나, 값은 줄여 더 적은 요청을 허용하도록 합니다.

시스템 구성 경로: 환경 > 레이트 제한
config.json 설정:

".RateLimitSettings.PerSec: 10, - 환경 변수:

MM_RATELIMITSETTINGS_PERSEC

최대 버스트 크기

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

레이트 제한이 활성화된 경우 초당 쿼리 제한을 초과하는 최대 수의 요청입니다.

숫자 입력입니다. 기본값은 100 입니다.

이 값을 늘리면 더 많은 동시 요청을 처리하도록 허용하고, 이 값을 줄이면 이 용량을 제한할 수 있습니다.

시스템 구성 경로: 환경 > 레이트 제한
config.json 설정:

".RateLimitSettings.MaxBu: 100, - 환경 변수:

MM_RATELIMITSETTINGS_MAXBURST

메모리 저장소 크기

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

레이트 제한이 활성화된 경우 시스템에 연결된 최대 사용자 세션 수입니다.

숫자 입력입니다. 기본값은 10000 입니다. 일반적으로 시스템의 사용자 수로 설정됩니다.

이 값은 예상 사용자 수로 설정하는 것이 좋습니다. 더 높은 값은 자원의 낭비를 초래할 수 있으며, 더 낮은 값은 사용자 세션이나 토큰이 너무 자주 만료될 수 있습니다.

시스템 구성 경로: 환경 > 레이트 제한
config.json 설정: ".RateLimitSettin gs.MemoryStoreSize: 10000,
환경 변수: MM_RATELIMI TSETTINGS_MEMORYSTORESIZE

원격 주소별 레이트 제한 다양화

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

레이트 제한이 활성화된 경우 IP 주소별로 API 액세스의 속도를 제한하도록 Mattermost를 구성합니다.

true : (기본값) IP 주소별로 API 액세스 속도를 제한합니다. 프록시를 사용할 때 권장됩니다.
false : IP 주소별로 레이트 제한이 다양화되지 않습니다.

시스템 구성 경로: 환경 > 레이트 제한
config.json 설정: ".RateLimitSettings .VaryByRemoteAddr: true,
환경 변수: MM_RATELIMITSETTI NGS_VARYBYREMOTEADDR

사용자별 레이트 제한 다양화

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

레이트 제한이 활성화된 경우 인증 토큰별로 API 액세스의 속도를 제한하도록 Mattermost를 구성합니다.

true : 사용자 인증 토큰에 의한 API 액세스 속도 제한. 프록시를 사용할 때 권장됩니다.
false : (기본값) 사용자 인증 토큰에 따라 속도 제한이 달라지지 않습니다.

시스템 구성 경로: 환경 > 속도 제한
config.json 설정: ".RateLimitSettings.V aryByUser: false,
환경 변수:

MM_RATELIMITSETTINGS_VARYBYUSER

HTTP 헤더별 속도 제한 변경

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Mattermost를 구성하여 지정된 HTTP 헤더 필드에 의해 API 액세스의 속도 제한을 변경할 수 있습니다. 프록시를 사용할 때 권장됩니다.

NGINX를 구성할 때, 이를 X-Real-IP 로 설정합니다.
AmazonELB를 구성할 때, 이를 X-Forwarded-For 로 설정합니다.

시스템 구성 경로: 환경 > 속도 제한
config.json 설정: ".RateLimitSe ttings.VaryByHeader: "",
환경 변수: MM_RATELIMITSE TTINGS_VARYBYHEADER

로깅

모든 플랜 에서 사용 가능

self-hosted 배포판

System Console > Environment > Logging 로 이동하여 또는 다음 표에 설명된 대로 config.json 파일을 편집하여 로깅을 구성하십시오. 이 섹션의 구성 설정을 변경하려면 서버를 다시 시작해야 적용됩니다.

Tip

Mattermost 알림에 대한 추가 로깅 구성을 NotificationLogSettings 아래의 config.json 파일에서 관리할 수 있습니다. 이러한 설정은 LogSettings 아래에서 사용 가능한 구성 설정과 동등합니다.

콘솔에 로그 출력

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Mattermost를 콘솔에 로그를 출력하도록 구성합니다.

true : (기본값) 콘솔 로그 레벨 #console-log-level 구성에 따라 서버는 메시지를 표준 출력 스트림 (stdout)에 기록합니다.
false : 로그 메시지가 콘솔에 기록되지 않습니다.

시스템 구성 경로: 환경 > 로깅
config.json 설정: ".LogSettings.En ableConsole": true",
환경 변수: MM_LOGSETTINGS_ENABLECONSOLE

콘솔 로그 레벨

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Mattermost가 로그 메시지를 콘솔에 출력할 때 쓰여지는 로그 이벤트의 상세 수준입니다.

DEBUG : (기본값) 개발자가 문제를 디버깅할 때 상세 정보를 출력합니다.
ERROR : 오직 오류 메시지만 출력합니다.
INFO : 시작 및 초기화에 대한 오류 메시지 및 정보를 출력합니다.

시스템 구성 경로: 환경 > 로깅
config.json 설정: ".LogSet tings.ConsoleLevel": DEBUG",
환경 변수: MM_LOGSETTINGS_CONSOLELEVEL

콘솔 로그를 JSON으로 출력

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Mattermost를 콘솔 로그를 JSON으로 출력하도록 구성합니다.

true : (기본값) 기계가 읽을 수 있는 JSON 형식으로 로그 이벤트를 기록합니다.
false : 로그 이벤트를 일반 텍스트로 기록합니다.

시스템 구성 경로: 환경 > 로깅
config.json 설정:

".LogSettings.ConsoleJson": true",

환경 변수: MM_LOGSETTINGS_CONSOLEJSON

참고 : 일반적으로 운영 환경에서는 true 로 설정됩니다.

일반 텍스트 콘솔 로그에 색상 적용

시스템 관리자가 일반 텍스트 로그 레벨 세부 정보에 색상을 표시할 수 있도록 합니다.

true : 로그 이벤트가 일반 텍스트로 콘솔에 출력될 때 로그 레벨 세부 정보에 색상이 추가됩니다.
false : (기본값) 일반 텍스트 로그 세부 정보에 색상이 표시되지 않습니다.

시스템 구성 경로: N/A
config.json 설정:

".LogSettings.EnableColor": false",

환경 변수: MM_LOGSETTINGS_ENABLECOLOR

로그를 파일에 출력

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Mattermost를 콘솔 로그를 파일에 출력하도록 구성합니다.

true : (기본값) 기존 file location 을 통해 구성된 디렉터리에 파일 로그레벨 구성에 따라 기록합니다.
false : 로그 이벤트가 파일에 기록되지 않습니다.

시스템 구성 경로: 환경 > 로깅
config.json 설정:

".LogSettings.EnableFile": true",

환경 변수: MM_LOGSETTINGS_ENABLEFILE

참고 : 일반적으로 운영 환경에서는 true 로 설정됩니다.

파일 로그 디렉터리

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

로그 파일의 위치입니다.

문자열을 입력하세요.

로그 파일은 ./logs 디렉터리에 저장됩니다.

시스템 구성 경로: 환경 > 로깅
true : (기본값) 진단 및 오류 보고서를 보냅니다.
false : 진단 및 오류 보고서가 전송되지 않습니다.

디렉터리에 저장됩니다. | |

세션 길이

모든 플랜 에서 사용 가능

self-hosted 배포판

사용자가 로그인을 시도하면 사용자 세션이 지워지고, 세션은 24시간마다 세션 데이터베이스 테이블에서 지워집니다. 시스템 콘솔 > 환경 > 세션 길이 로 이동하여 세션 길이를 구성하거나, 다음 표에 설명된 대로 config.json 파일을 편집하여 세션 길이를 구성할 수 있습니다. 이 섹션의 구성 설정을 변경한 후에는 서버를 재시작해야 설정이 적용됩니다.

활동으로 세션 길이 연장

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

사용자가 Mattermost 앱에서 활동 중일 때 세션을 연장하여 사용자가 로그인한 상태를 유지하여 사용자 경험을 개선합니다.

true : (기본값) 사용자가 Mattermost 클라이언트에서 활동 중일 때 세션은 자동으로 연장됩니다. 사용자 세션이 정의된 세션 길이 동안 전체 기간 동안 Mattermost 클라이언트에서 활동하지 않는 경우에만 사용자 세션이 만료됩니다.
false : Mattermost에서 활동으로 세션이 연장되지 않습니다. 사용자 세션은 세션 길이의 종료 시간 또는 세션 유휴 시간 에 따라 즉시 만료됩니다.

시스템 구성 경로: 환경 > 세션 길이
config.json 설정: ".ServiceSettings.ExtendSessio nLengthWithActivity: true,
환경 변수: MM_SERVICESETTINGS_EXTENDSES SIONLENGTHWITHACTIVITY

AD/LDAP 및 이메일의 세션 길이

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

웹 앱 또는 데스크톱 앱에 마지막으로 사용자 자격 증명을 입력한 후 이메일 및 AD/LDAP 인증에서 사용자 세션이 만료될 때까지 계산된 시간 수를 설정합니다.

시간 단위의 숫자 입력. 기본값은 720 시간입니다.

시스템 구성 경로: 환경 > 세션 길이
config.json 설정: ".ServiceSettings.Ses sionLengthWebInHours: 720,
환경 변수: MM_SERVICESET TINGS_SESSONLENGTHWEBINHOURS

참고 : 이 설정을 변경한 후에는 새로운 세션 길이가 사용자가 다음으로 자격 증명을 입력한 후에 적용됩니다.

모바일의 세션 길이

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

모바일 앱에 마지막으로 사용자 자격 증명을 입력한 후 사용자 세션이 만료될 때까지 계산된 시간 수를 설정합니다.

시간 단위의 숫자 입력. 기본값은 720 시간입니다.

시스템 구성 경로: 환경 > 세션 길이
config.json 설정: ".ServiceSettings.Sessio nLengthMobileInHours: 720,
환경 변수: MM_SERVICESETTINGS_S ESSONLENGTHMOBILEINHOURS

참고 : 이 설정을 변경한 후에는 새로운 세션 길이가 사용자가 다음으로 자격 증명을 입력한 후에 적용됩니다.

SSO의 세션 길이

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

사용자가 SSO 자격 증명을 마지막으로 입력한 후 사용자 세션이 만료될 때까지 계산된 시간 수를 설정합니다. 이 설정은 SAML, GitLab 및 OAuth 2.0과 같은 SSO 인증에 대한 세션 길이를 정의합니다.

시간 단위의 숫자 입력. 기본값은 720 시간입니다. 이 구성 설정에 대해 소수점으로 된 숫자도 유효한 값입니다.

시스템 구성 경로: 환경 > 세션 길이
config.json 설정: ".ServiceSettings.Sessi onLengthSSOInHours: 720,
환경 변수: MM_SERVICESETTINGS _SESSONLENGTHSSOINHOURS

참고 :

이 설정을 변경한 후에는 새로운 세션 길이가 사용자가 다음으로 자격 증명을 입력한 후에 적용됩니다.
인증 방법이 SAML, GitLab 또는 OAuth 2.0인 경우 이미 SAML, GitLab 또는 OAuth 2.0에 로그인되어 있는 경우에는 사용자가 자동으로 Mattermost에 다시 로그인될 수 있습니다.

세션 캐시

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

메모리에 세션을 캐시하는 시간(분) 수를 설정합니다.

분 단위의 숫자 입력. 기본값은 10 분입니다.

시스템 구성 경로: 환경 > 세션 길이
config.json 설정: ".ServiceSettings.Ses sionCacheInMinutes: 10,
환경 변수: MM_SERVICES ETTINGS_SESSONCACHEINMINUTES

세션 유휴 시간

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

성능 모니터링

Enterprise 플랜에서 사용 가능

self-hosted 배포판

성능 모니터링을 구성하려면 시스템 콘솔 > 환경 > 성능 모니터링 으로 이동하거나, 다음 표에 설명된 대로 config.json 파일을 편집하세요. 이 섹션의 구성 설정을 변경하려면 서버를 다시 시작해야 합니다.

성능 모니터링 활성화

이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.

성능 모니터링을 활성화 또는 비활성화합니다.

true : 성능 모니터링 데이터 수집 및 프로파일링이 활성화됩니다.
false : (기본값) Mattermost 성능 모니터링이 비활성화됩니다.

시스템 구성 경로: 환경 > 성능 모니터링
config.json 설정:

".MetricsSettings.Enable": false",

환경 변수: MM_METRICSSETTINGS_ENABLE

더 알아보려면 성능 모니터링 설명서를 참조하세요.

성능용 청취 주소

이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.

활성화된 경우 Mattermost 서버가 성능 메트릭을 노출하기 위해 청취할 포트입니다.

숫자 입력. 기본값은 8067 입니다.

시스템 구성 경로: 환경 > 성능 모니터링
config.json 설정: ".MetricsSettings.List enAddress": 8067",
환경 변수: MM_METRICSSETTIN GS_LISTENADDRESS

개발자

모든 플랜 에서 사용 가능

self-hosted 배포판

시스템 콘솔 > 환경 > 개발자 로 이동하여 개발자 모드 구성, 또는 다음 표에 설명된대로 config.json 파일을 편집하여 개발자 모드를 구성합니다. 이 섹션의 구성 설정 변경은 적용되기 전에 서버를 재시작해야 합니다.

테스트 명령어 사용 가능 여부

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

/test 슬래시 명령어를 활성화 또는 비활성화합니다.

true : (기본값) /test 슬래시 명령어는 테스트 계정 및 테스트 데이터를 불러오는 데 사용됩니다.
false : test 슬래시 명령어가 비활성화됩니다.

시스템 설정 경로: 환경 > 개발자
config.json 설정: ".ServiceSettin gs.EnableTesting": true",
환경 변수: MM_SERVICESETTINGS_ENABLETESTING

개발자 모드 활성화

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

개발자 모드를 활성화 또는 비활성화합니다.

true : (기본값) 자바스크립트 오류가 Mattermost 사용자 인터페이스 상단에 배너로 표시됩니다. 프로덕션 환경에서 사용이 권장되지 않습니다.
false : 사용자에게 자바스크립트 오류가 표시되지 않습니다.

시스템 설정 경로: 환경 > 개발자
config.json 설정: ".ServiceSettings .EnableDeveloper": true",
환경 변수:

MM_SERVICESETTINGS_ENABLEDEVELOPER

클라이언트 디버깅 활성화

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

개별 사용자를 위한 설정 > 고급 > 디버깅 에서 찾을 수 있는 클라이언트 측 디버깅 설정을 활성화 또는 비활성화합니다.

true : 해당 설정이 표시되어 사용자가 활성화할 수 있습니다.
false : (기본값) 해당 설정이 숨겨지고 비활성화됩니다.

시스템 설정 경로: 환경 > 개발자
config.json 설정: ".ServiceSettings.EnableClientPer formanceDebugging": false",
환경 변수: MM_SERVICESETTINGS_E NABLECLIENTPERFORMANCEDEBUGGING

클라이언트 디버깅 설명서에서 자세한 내용을 확인하세요.

신뢰되지 않는 내부 연결 허용

이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.

Mattermost 서버가 로컬 네트워크 내에서 신뢰할 수 없는 요청을 수행하는 능력을 제한합니다. 클라이언트를 대표하여 수행되는 요청은 “신뢰할 수 없음”으로 간주됩니다.	시스템 구성 경로: 환경 > 개발자 `config.json` 설정: `".ServiceSettings.AllowedUntrustedInternalConnections": "",` 환경 변수: `MM_SERVICESETTINGS_ALLOWEDUNTRUSTEDINTERNALCONNECTIONS`
이 설정은 Mattermost 서버에서 요청할 수 있는 로컬 네트워크 주소의 화이트리스트입니다. 호스트 이름, IP 주소 및 액세스할 수 있는 CIDR 범위의 공백으로 구분된 목록으로 구성됩니다. 시스템 관리자만 구성할 수 있는 요청은 신뢰할 수 있으며이 설정에 영향을받지 않습니다. 신뢰할 수 있는 URL에는 OAuth 로그인이나 푸시 알림을 보내는 데 사용되는 URL 등이 포함됩니다. 다음 기능은 신뢰할 수 없는 요청을 수행하며이 설정에 영향을 받습니다. 웹훅, 슬래시 명령 또는 메시지 작업을 사용하는 통합. 이는 로컬 네트워크 내의 엔드포인트를 요청하는 것을 방지합니다. 링크 프리뷰. 채팅 메시지에 로컬 네트워크 주소로 링크가 게시되면 링크 프리뷰가 표시되지 않습니다. 로컬 이미지 프록시. 로컬 이미지 프록시가 활성화 된 경우 통합이나 채팅 메시지에서 로컬 네트워크에 있는 이미지를 사용할 수 없습니다.
이 설정을 수정해야 할 때의 몇 가지 예시는 다음과 같습니다. 자체 이미지를 포함한 플러그인을 설치할 때 (예: Matterpoll)에는 Mattermost 서버의 도메인 이름을 이 목록에 추가해야 합니다. 로컬 네트워크에서 봇이나 웹훅 기반 통합을 실행하는 경우 해당 목록에 봇/통합의 호스트 이름을 추가해야 합니다. 만약 Mattermost 서버가 내부 IP 주소를 사용하여 로컬 네트워크의 기밀 데이터를 요청한다면 해당 서버의 호스트 이름은 이 목록에 추가되어야 합니다.
경고: 이 설정은 로컬 네트워크 외부에 있는 사용자가 Mattermost 서버를 사용하여 로컬 네트워크에서 기밀 데이터를 요청하는 것을 방지하기 위해 만들어졌습니다. 이 설정을 구성할 때는 로컬 네트워크로의 부정한 액세스를 방지하기 위해 신중해야 합니다.
참고 사항: - Mattermost 애플리케이션 서버 자체의 공용 IP도 예약된 IP로 간주됩니다. - 호스트 이름, IP 주소 또는 CIDR 범위를 나열할 때 쉼표 대신 공백을 사용하세요. 예: `webhooks.internal.example.com`, `127.0.0.1`, 또는 `10.0.16.0/28`. IP 주소 및 도메인 이름 규칙은 호스트 해결 전에 적용됩니다. CIDR 규칙은 호스트 해결 후에만 적용되며, CIDR 규칙만이 DNS 해결을 필요로 합니다. Mattermost는 심지어 해결하지 않고 IP 주소와 호스트 이름을 일치시키려고 시도합니다. 실패 시, Mattermost는 로컬 리졸버를 사용하여 해결(예: `/etc/hosts` 파일 읽기)한 다음 일치하는 CIDR 규칙을 확인합니다. 예를 들어 도메인 “webhooks.internal.example.com”이 IP 주소 `10.0.16.20` 으로 해결되면 URL이 `https://webhooks.internal.example.com/webhook` 인 웹훅은 `webhooks.internal.example.com` 또는 `10.0.16.16/28` 으로 화이트리스트에 등록될 수 있지만, `10.0.16.20` 으로는 등록되지 않습니다.

Mattermost 원문 보기