환경 구성 설정
모든 플랜 에서 사용 가능
self-hosted 배포판
Tip
아래 각 구성 값은 JSON-aware 도구를 사용하여 config.json
파일에서 프로그래밍 방식으로 값을 액세스하기 위한 JSON 경로를 포함합니다. 예를 들어 SiteURL
값은 ServiceSettings
아래에 있습니다.
jq 와 같은 도구를 사용하는 경우, 다음을 입력하십시오:
cat config/config.json | jq '.ServiceSettings.SiteURL'
config.json
파일을 수동으로 처리하는 경우,ServiceSettings
키를 찾은 다음 해당 개체 내에서SiteURL
키를 찾으십시오.
자체 호스트 및 클라우드 관리자 모두 시스템 콘솔 > 환경 에서 다음 구성 설정에 액세스할 수 있습니다. 자체 호스트 관리자는 아래 표에 설명된대로 config.json
파일을 편집할 수도 있습니다.
웹 서버
모든 플랜 에서 사용 가능
self-hosted 배포판
Mattermost가 배포된 네트워크 환경을 구성하려면 시스템 콘솔 > 환경 > 웹 서버 로 이동하거나, 다음 테이블에 설명된 대로 config.json
파일을 업데이트하세요. 이 섹션의 구성 설정 변경은 적용되기 전에 서버를 다시 시작해야 합니다.
사이트 URL
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
사용자가 Mattermost에 액세스하는 데 사용하는 URL입니다. 표준 포트가 아닌 경우 포트 번호가 필요합니다. 이 필드는 필수입니다. 시스템 콘솔에서 라이브 URL 테스트 버튼을 선택하여 사이트 URL을 유효성 검사합니다. |
|
참고:
|
웹 서버 수신 주소
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
바인딩 및 수신할 주소와
포트입니다. 낮은 수준의 포트(“시스템 포트” 또는 “잘 알려진 포트”로 불리는 0-1023 범위 내)를 선택하는 경우 해당 포트에 바인딩할 권한이 있어야 합니다. |
|
포트 80을 443으로 전달
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
포트 80에서 443으로 보안되지 않은 트래픽을 전달합니다.
|
|
웹 서버 연결 보안
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
Mattermost 클라이언트와 서버 간의 연결 보안입니다.
|
|
TLS 인증서 파일
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
TLS 연결 보안에 사용할 인증서 파일의 경로입니다. 문자열 입력입니다. |
|
TLS 키 파일
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
TLS 연결 보안에 사용할 TLS 키 파일의 경로입니다. 문자열 입력입니다. |
|
Let’s Encrypt 사용
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
Let’s Encrypt에서 인증서를 자동으로 가져오도록 설정합니다. Let’s Encrypt 설정에 대한 자세한 내용은 Mattermost 문서에서 TLS 구성 을 참조하세요.
|
|
Let’s Encrypt 인증서 캐시 파일
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
Let’s Encrypt 서비스에 대한 인증서 및 기타 데이터를 저장할 파일의 경로입니다. 파일 경로 입력입니다. |
|
읽기 시간 초과
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
연결 수락부터 요청 본문이 완전히 읽힐 때까지 허용되는 최대 시간입니다. 초 단위의 숫자 입력입니다. 기본값은 300 초입니다. |
|
쓰기 시간 초과
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
초 단위의 숫자 입력입니다. 기본값은 300 초입니다. |
|
유휴 시간 초과
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
HTTP 서버에서 명시적인 유휴 시간 초과를 설정합니다. 유휴 상태의 연결이 끊기기 전에 허용되는 최대 시간입니다. 초 단위의 숫자 입력입니다. 기본값은 300 초입니다. |
|
웹서버 모드
이 기능은 레거시 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를 구성하여 안전하지 않은 외부 연결을 허용합니다.
|
|
보안 참고 : 이 기능을 활성화하면 이러한 연결이 중간자 공격에 취약해집니다. |
관리되는 리소스 경로
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
Mattermost 도메인 내에서 Mattermost 자체가 아닌 서드 파티 서비스에 의해 관리되는 경로들의 쉼표로 구분된 목록입니다. Mattermost 앱에서 이러한 경로에 대한 링크는 새 탭/창에서 열립니다. 예를 들어, 만약
Mattermost가
|
|
참고 : Mattermost 데스크톱 앱을 사용할 때는 링크를 브라우저가 아닌 데스크톱 앱에서 열기 위해 추가 구성이 필요합니다. 자세한 내용은 데스크톱 관리 리 소스 문서를 참조하세요. |
디스크로부터 구성 다시 불러오기
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
서버를 중지시키지 않고 장애
조치를 위해 데이터베이스 구성을 변경한 후 시스템 콘솔에서 디스크로부터 구성 다시 불러오기 버튼을 선택하세요. 그리고나서 환경 > 데이터베이스 로 이동하여 데이터베이스 연결 재생성 을 선택하여 구성을 완료하세요. |
|
모든 캐시 삭제
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
세션, 계정 및 채널에 대한 모든 인메모리 캐시를 삭제해야 합니다. 시스템 콘솔에서 모든 캐시를 삭제하는 모든 캐시 삭제 버튼을 선택하세요. |
|
참고 : 캐시를 삭제하는 것은 성능에 불이익을 줄 수 있습니다. 고가용성 클러스터 를 사용하는 배포는 클러스터의 모든 서버를 삭제하려고 할 것입니다. |
웹소켓 URL
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
클라이언트에게 웹소켓을 연결하도록 서버를 구성할 수 있습니다. 문자열 입력. |
|
라이선스 파일 위치
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
디스크상의 라이선스 파일의 경로와 파일 이름입니다. 부팅 시, Mattermost가 이전 업로드에서 데이터베이스에 유효한 라이선스를 찾지 못하면, 이 경로에서 라이선스 파일을 검색합니다. 문자열 입력. 절대 경로 또는
|
|
TLS 최소 버전
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
Mattermost 서버에서 사용하는 최소 TLS 버전입니다. 문자열 입력. 기본값은 1.2 입니다. |
|
참고 : 이 설정은 내장된 서버 이진 파일을 직접 사용하고 NGINX와 같은 리버스 프록시 계층을 사용하지 않는 경우에만 영향을 미칩니다. |
신뢰할 수 있는 프록시 IP 헤더
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
IP 주소를 순서대로 확인할 지정된 헤더입니다. 다른 모든 헤더는 무시됩니다.
|
|
참고사항 :
|
Strict Transport Security (HSTS) 활성화
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
|
|
Strict-Tra nsport-Security 문서에서 자세한 내용을 확인하세요. |
안전한 TLS 전송 만료
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
브라우저가 사이트를
HTTPS를 통해서만
액세스해야 함을 기억하는
시간(초). 이 기간
이후에는
`
TLSStrictTransport`가
숫자 입력. 기본값은 63072000 (2년) 입니다. |
|
Strict-Transpo rt-Security 문서에서 자세한 내용을 확인하세요. |
TLS 암호 덮어쓰기
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
현재 고려되는 안전한 암호 집합을 사용하여 Mattermost 서버가 가정하는 경우, 또는 허용된 암호 유형을 제한하기 위해 TLS 암호 덮어쓰기를 설정합니다. 지정되지 않은 경우 엣지 케이스에서 덮어쓰기를 허용합니다. 문자열 배열 입력. |
|
참고사항 : 이 설정은 내장 서버 바이너리를 직접 사용하고 NGINX와
같은 역방향 프록시 레이어를 사용하지 않을 때만 적용됩니다.
-
|
고루틴 상태 임계값
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
매터모스트 시스템이 건강한 상태로 간주되는 고루틴의 수에 대한 임계값 설정. 고루틴이 이 한도를 초과하면 서버 로그에 경고가 표시됩니다. 숫자 입력. 기본값은 -1입니다. 이 값은 임계값 확인을 끕니다. |
|
서브도메인에 대한 쿠키 허용
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
|
|
클러스터 로그 시간 제한
이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.
클러스터 요청 시간 로깅 주기를 정의합니다. 성능 모니터링을 위한 밀리초(millisecond) 단위. 숫자 입력. 기본값은 2000 밀리초(2초)입니다. |
|
자세한 내용은 성능 모니터링(performance monitoring) 문서를 참조하세요. |
데이터베이스
모든 플랜 에서 사용 가능
self-hosted 배포판
드라이버 이름
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
데이터베이스 유형입니다. 다음 중 하나를 사용할 수 있습니다:
|
|
데이터 원본
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
마스터 데이터베이스로의 연결 문자열입니다. 문자열 입력입니다. |
|
SSL을 활성화하려면:
|
|
PostgreSQL 데이터베이스 드라이버 이름 이
|
|
MySQL 데이터베이스 드라이버 이름 이
정렬 순서를 지정하려면: "SqlSettings": {
"DataSource":
"<user:pass>@<servername>/ma
ttermost?charset=utf8mb4,u
tf8&collation=utf8mb4_gener
al_ci",
[...]
}
정렬 순서를 지정하지 않으면
기본 정렬 순서인
"SqlSettings": {
"DataSource":
"<user:pass>@<servername>/mat
termost?charset=utf8mb4
,utf8",
[...]
}
참고 : MySQL 8.0 이상을
사용하는 경우, 기본 정렬
순서가
|
최대 유휴 데이터베이스 연결
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
데이터베이스에 유지되는 최대 유휴 연결 수입니다. 숫자 입력입니다. 기본값은 10 입니다. |
|
최대 개방 연결
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
데이터베이스에 대한 최대 오픈 연결 수입니다. 숫자 입력입니다. 자체 호스팅 배포의 기본값은 300 이고, 클라우드 배포의 기본값은 100 입니다. |
|
쿼리 시간 초과
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
연결을 열고 쿼리를 보내고 나서 데이터베이스로부터 응답을 기다리는 시간입니다. 초 단위로 숫자 입력입니다. 기본값은 30 초입니다. |
|
최대 연결 수명
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
데이터베이스에 대한 연결의 최대 수명(밀리초 단위). 데이터베이스에 대한 연결을 재사용할 수 있는 최대 시간을 구성하는 데 사용됩니다. 밀리초(millisecond)로 숫자 입력. 기본값은 3600000 밀리초(1시간)입니다. |
|
최대 연결 대기 시간
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
데이터베이스 연결이 대기할 수 있는 최대 시간(밀리초 단위). 밀리초(millisecond)로 숫자 입력. 기본값은 300000 밀리초(5분)입니다. |
|
최소 해시태그 길이
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
해시태그 내 문자의 최소 수. 이 값은 2 이상이어야 합니다. |
|
참고 : MySQL 데이터베이스는 세 글자보다 짧은 문자열을 검색할 수 있도록 구성되어야 합니다. 자세한 내용은 MySQL 문서 를 참조하세요. |
SQL 문 로깅
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
실행된 SQL 문을 개발을 위해 로그에 기록할 수 있습니다.
|
|
데이터베이스 연결 재사용
이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.
데이터베이스 연결 재활용 버튼을 선택하여 데이터베이스로의 현재 오픈된 연결 세트를 20초 이내에 닫고, 새로운 연결 세트를 만듭니다. 서버를 중지하지 않고 장애
조치하려면, |
|
데이터베이스 검색 비활성화
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
Elasticsearch 와 같은 다른 검색 엔진이 구성된 경우, 데이터베이스를 비활성화하여 검색을 수행할 수 있습니다.
|
|
Mattermost에서의 검색 동작은 사용 가능한 검색 엔진에 따라 다릅니다.
|
적용된 스키마 마이그레이션
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
데이터 스토어에서 사용 가능한 버전 정보를 기반으로 적용된 모든
마이그레이션 리스트가 db_migrations
테이블에서 확인 가능합니다.
배포된 현재 데이터베이스 스키마 버전을 검토하려면 제품 메뉴에서
Mattermost 정보 를 선택하세요.
활성 검색 백엔드
검색에 사용되는 현재 활성화된 백엔드의 읽기 전용 표시입니다. 값은
none
, database
, elasticsearch
, bleve
를 포함할 수
있습니다.
리드 레플리카
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
리드 레플리카 데이터베이스의 연결 문자열을 지정합니다. |
|
참고 : 배열 내의 각 데이터베이스 연결 문자열은 데이터 원본 설정과 사용하는 동일한 형식이어야 합니다. |
검색 레플리카
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
검색 레플리카 데이터베이스의 연결 문자열을 지정합니다. 검색 레플리카는 리드 레플리카와 유사하지만 검색 쿼리 처리에만 사용됩니다. |
|
참고 : 배열 내의 각 데이터베이스 연결 문자열은 데이터 원본 설정과 사용하는 동일한 형식이어야 합니다. |
레플리카 랙 설정
이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.
문자열 배열 입력은 단일 레플리카 인스턴스에 대해 레플리카 랙을 측정하기 위한 연결 문자열 및 사용자 정의 SQL 쿼리를 지정합니다. 이러한 설정은 바이너리 로그 거리/트랜잭션 대기열 길이를 기반으로 절대 랙을 모니터링하며, 레플리카가 따라잡는 데 걸리는 시간을 측정합니다. 문자열 배열 입력은 다음을 포함합니다:
|
|
참고 사항 :
|
데이터베이스 유형에 따라 복제 지연 지표를 구성합니다. 각 데이터베이스 유형에 대한 구성 세부 정보는 다음 탭을 참조하십시오.
아래 강조된 구성을
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초입니다. |
|
Elasticsearch
Enterprise 플랜에서 사용 가능
self-hosted 배포판
Elasticsearch은 엔터프라이즈 규모의 배포를 제공하며 최적화된 검색 성능을 제공하고 성능 저하와 타임아웃을 방지합니다. 자세한 내용은 당사의 제품 설명서에서 Elasticsearch 를 확인하세요.
시스템 콘솔 > 환경 > Elasticsearch 에서 Mattermost가 배포된 Elasticsearch 환경을 구성할 수 있습니다. 또한 다음 표에 설명된대로
config.json
파일을 편집할 수 있습니다. 이 섹션의 구성 설정을 변경하려면 적용되기 전에 서버를 재시작해야 합니다.
Elasticsearch 인덱싱 활성화
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
새 게시물을 자동으로 색인하도록 Mattermost를 구성합니다.
|
|
참고 사항:
|
서버 연결 주소
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
Elasticsearch 서버의 주소입니다. |
|
CA 경로
Elasticsearch 서버의 사용자 정의 인증서 기관 인증서의 선택적인 경로입니다. |
|
참고 : Mattermost v7.8부터 사용 가능합니다. 기본 인증서 기관 인증서를 사용하려면 이 설정을 비워두십시오. |
클라이언트 인증서 경로
Elasticsearch 서버에 대한 PEM 형식의 선택적인 클라이언트 인증서입니다. |
|
참고 : Mattermost v7.8부터 사용 가능합니다. 기본 기본 인증 자격 증명과 함께 사용하거나 대체하는 데 사용할 수 있습니다. |
클라이언트 인증서 키 경로
PEM 형식의 클라이언트 인증서의 선택적인 키입니다. |
|
참고 : Mattermost v7.8부터 사용 가능합니다. 기본 기본 인증 자격 증명과 함께 사용하거나 대체하는 데 사용할 수 있습니다. |
TLS 인증 확인 건너뛰기
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
TLS 연결에 대한 인증 단계를 건너뛸 수 있습니다.
|
|
서버 사용자 이름
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
(Optional) Elasticsearch 서버에 인증하기 위한 사용자 이름입니다. 문자열 입력. |
|
서버 비밀번호
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
(Optional) Elasticsearch 서버에 인증하기 위한 비밀번호입니다. 문자열 입력. |
|
클러스터 스니핑 활성화
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
Mattermost를 구성하여 클러스터의 모든 데이터 노드를 자동으로 찾아 연결하도록 합니다.
|
|
시스템 콘솔에서 연결 테스트 버튼을 선택하여 Mattermost와 Elasticsearch 서버 간의 연결을 확인합니다. |
대량 색인
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
Mattermost를 구성하여 데이터베이스에 있는 모든 기존 글을 대량 색인하도록 합니다. |
|
시스템 콘솔에서 지금 색인 버튼을 선택하여 모든 글을 대량 색인 시작합니다. 색인 프로세스가 취소되면 색인 및 검색 결과가 불완전해집니다. |
색인 정리 중 무시할 색인 이름을 지정합니다.
색인 정리 중 무시할 색인 이름을 지정합니다. 쉼표로 여러 개의 색인 이름을 구분합니다. 별표(*)를 사용하여 일련의 색인 이름을 일치시킬 수 있습니다. |
|
색인 정리
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
전체 Elasticsearch 색인을 정리합니다. 일반적으로 색인이 손상되었거나 검색이 예상대로 작동하지 않을 때 사용됩니다. |
|
색인을 정리하려면 시스템 콘솔에서 색인 정리 버튼을 선택하십시오. 색인을 정리한 후, 지금 색인 버튼을 선택하여 새 색인을 만듭니다. |
검색 쿼리에 대한 Elasticsearch 활성화
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
최신 색인을 사용하여 모든 검색 쿼리에 대해 Elasticsearch를 사용하도록 Mattermost를 구성합니다.
|
|
자동완성 쿼리에 대한 Elasticsearch 활성화
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
최신 색인을 사용하여 사용자 및 채널에 대한 모든 자동완성 쿼리에 대해 Elasticsearch를 사용하도록 Mattermost를 구성합니다.
|
|
참고: 자동완성 결과는 기존 사용자 및 채널 데이터베이스의 대량 색인이 완료될 때까지 불완전할 수 있습니다. |
게시물 색인 복제본
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
각 게시물 색인에 사용할 복제본 수입니다. 숫자 입력. 기본값은 1 입니다. |
|
중요 사항: 이 설정을 변경하면 변경된 구성이 새로 생성된 색인에만 적용됩니다. 기존 색인에 변경을 적용하려면 이 설정을 변경한 후 색인을 정리하고 다시 작성해야 합니다. |
게시물 색인 샤드
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
각 게시물 색인에 사용할 샤드 수입니다. 숫자 입력. 기본값은 1 입니다. |
|
중요 사항: 이 설정을 변경하면 변경된 구성이 새로 생성된 색인에만 적용됩니다. 기존 색인에 변경을 적용하려면 이 설정을 변경한 후 색인을 정리하고 다시 작성해야 합니다. |
채널 색인 복제본
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
각 채널 색인에 사용할 복제본 수입니다. 숫자 입력. 기본값은 1입니다. |
|
채널 색인 샤드
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
각 채널 색인에 사용할 샤드 수입니다. 숫자 입력. 기본값은 1 입니다. |
|
사용자 색인 복제본
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
각 사용자 색인에 사용할 복제본 수입니다. 숫자 입력. 기본값은 1 입니다. |
|
사용자 색인 샤드
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
각 사용자 색인에 사용할 샤드 수입니다. 숫자 입력. 기본값은 1 입니다. |
|
검색 인덱스 집계
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
이 설정에서 지정한 일(day) 단위로 Elasticsearch 인덱스(index)가 집계되는 나이 이전의 Elasticsearch 인덱스(index)입니다. 숫자 입력. 기본값은 365 일입니다. |
|
참고 : 데이터 보존 정책 및 Elasticsearch 을 사용하는 경우, 데이터 보존 정책보다 큰 값을 설정하세요. |
게시물 집계기 시작 시간
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
일일 예약된 집계기 작업의 시작 시간입니다. 서버의 지역 시간을
기준으로 된 24시간 형식의
기준 시간이어야 합니다.
기본값은 03:00 (오전 3시)입니다. |
|
인덱스 접두어
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
추가되는 Elasticsearch 인덱스(index) 이름 앞에 붙는 접두어입니다. |
|
참고 : 이 설정을 사용하는 경우, Mattermost가 생성하는 모든 Elasticsearch 인덱스(index)에는 이 접두어가 붙습니다. 인덱스 이름이 충돌하지 않도록 서로 다른 접두사를 설정할 수 있습니다. |
실시간 인덱싱 일괄 처리 크기
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
Elasticsearch 인덱스(index)에 추가되기 전에 필요한 새로운 게시물의 수입니다. 인덱싱 후, 게시물은 검색 가능해집니다. 초당 1개 이상의 게시물이 있는 서버에서는 이 값을 20초 동안의 평균 게시물 수로 설정하는 것이 좋습니다. 숫자 입력. 기본값은 1 입니다. 게시물은 생성될 때 동기적으로 인덱싱됩니다. |
|
참고 : 초당 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개의 게시물이 데이터베이스에 추가되는 경우에 대한 평균 초 값을 기준으로 근사값을 계산하세요.) |
|
참고: 이 값을 너무 낮게 설정하면 대량 색인 작업이 느리게 실행될 수 있습니다. |
Request timeout
Elasticsearch 호출의 타임아웃(초)입니다. 초 단위의 숫자 입력. 기본값은 30초입니다. |
|
Trace
이전 기업용 버전 E10/E20에서 사용 가능
파일 저장소
모든 플랜 에서 사용 가능
self-hosted 배포판
‘System Console > Environment > File Storage’ 로 이동하여 또는 다음 표에 설명된대로 config.json
파일을 편집하여 파일 저장 설정을 구성합니다.
![](../_static/images/badges/academy-callout-image.jpg)
Note
Mattermost는 현재 로컬 파일 시스템 및 Amazon S3 또는 호환되는 S3에 파일을 저장하는 것을 지원합니다. Mattermost는 MinIO 및 Digital Ocean Spaces 제품과 테스트되었으나 시장에서 모든 호환되는 S3 컨테이너를 테스트한 것은 아닙니다. 기타 호환되는 S3 컨테이너를 사용하려면 직접 테스트를 완료하는 것을 권장합니다.
파일 저장 시스템
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
사용되는 파일 저장 시스템의 유형입니다. 로컬 파일 시스템 또는 Amazon S3일 수 있습니다.
|
|
로컬 저장소 디렉터리
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
파일 저장 시스템 이 로컬 로 설정된 경우 파일이 쓰여지는 로컬 디렉터리입니다. Mattermost가 실행 중인 사용자가 쓰기 가능한 어떤 디렉터리든 관계없으며 Mattermost가 설치된 디렉터리를 기준으로 상대적입니다. 기본값은 .data 입니다. |
|
참고 : 파일 저장 시스템 이 amazons3 로 설정된 경우, 이 설정은 영향을 미치지 않습니다. |
최대 파일 크기
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
메시지 첨부 파일의 최대 파일
크기입니다. 이 값은 시스템
콘솔에서 메가바이트로 지정해야
하며 기본값은 |
|
경고 : 서버 메모리가 설정 선택을 지원할 수 있는지 확인하세요. 대용량 파일 크기는 서버 충돌 및 네트워크 중단으로 인한 업로드 실패 위험을 증가시킵니다. |
|
참고 : Mattermost 앞에 프록시 또는 로드 밸런서를 사용하는 경우 다음 프록시 설정을 해당되는 대로 조정해야 합니다:
|
컨텐츠별 문서 검색 활성화
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
사용자들이 메시지에 첨부된 문서의 내용을 검색할 수 있도록 활성화합니다.
|
|
참고 : Mattermost Server v5.35로 업그레이드하기 전에 메시지로 공유된 파일에 대한 문서 내용 검색 결과가 부족할 수 있으며, mmctl 을 사용하여 추출 명령을 실행하기 전까지 완전하지 않을 수 있습니다. 이 명령을 실행하지 않으면 사용자는 이전 파일을 파일 이름을 기반으로 검색할 수 있습니다. PDF, DOCX 및 ODT 이외의 파일 형식(PDF, DOCX 및 ODT 포함)을 Mattermost에서 내용 검색 지원을 확장하려면 다음 의존 성 을 선택적으로 설치할 수 있습니다:
이러한 의존성을 설치하지 않을 경우, 추출할 수 없는 문서에 대한 로그 항목이 표시됩니다. 추출할 수 없는 문서는 건너뛰고 내용 추출이 진행됩니다. |
압축된 파일 안 문서 내용 검색 활성화
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
메시지에 첨부된 압축된 ZIP 파일의 내용을 검색할 수 있게 합니다.
|
|
참고 : ZIP 파일 내 문서 내용 검색은 모바일 지원이 곧 제공됩니다. 문서 내용 검색은 서버에 부하를 추가합니다. 대규모 배포나 많은 대용량 텍스트 문서를 공유하는 팀의 경우, 프로덕션 환경에서 활성화하기 전에 스테이징 환경에서 이 기능을 활성화하고 하드웨어 요구 사항을 검토하는 것을 권장합니다. 하드웨어 요구 사항 을 확인하고 테스트해 주세요. |
Amazon S3 버킷
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
S3 호환 객체 저장소 인스턴스의 버킷 이름입니다. S3 호환 버킷 이름을 포함하는 문자열입니다. |
|
Amazon S3 경로 접두어
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
Amazon S3 버킷 에서 선택한 접두어입니다. 경로 접두어를 포함하는 문자열입니다. |
|
Amazon S3 지역
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
AWS에서 Amazon S3 버킷 을 생성할 때 선택한 지역입니다. 버킷을 포함하는 AWS 지역을 나타내는 문자열입니다. 지역이 설정되지 않으면 Mattermost는 적절한 지역을 AWS에서 가져오려 시도하고 발견하지 못할 경우 us-east-1 로 설정합니다. |
|
참고 : MinIO 또는 Digital Ocean Spaces의 경우, 이 설정을 비워 두세요. |
Amazon S3 액세스 키 ID
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
S3 호환 저장소 인스턴스의 액세스 키를 나타내는 문자열입니다. EC2 관리자가 액세스 키 ID를 제공할 수 있습니다. |
|
참고 : 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 호환 스토리지 인스턴스의 시크릿 액세스 키를 나타내는 문자열입니다. |
|
안전한 Amazon S3 연결 활성화
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
Amazon S3 연결을 안전하게 활성화하거나 비활성화합니다.
|
|
Amazon S3 서명 v2
이전 엔터프라이즈 에디션 E10/E20에서 사용 불가
Mattermost는 기본적으로 AWS에 대한 API 호출에 Signature v4를 사용하지만, 특정 상황에서는 v2가 필요할 수 있습니다.
|
|
Amazon S3 서명 v2 서명 프로세스를 사용해야 하는 경우에 대한 자세한 정보는 AWS 문서 를 참조하십시오. |
Amazon S3를 위한 서버 측 암호화 활성화
이전 엔터프라이즈 에디션 E20에서 사용 가능
Amazon S3를 위한 서버 측 암호화를 활성화하거나 비활성화합니다.
|
|
Amazon S3 디버깅 활성화
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
Amazon S3 디버깅을 활성화하거나 비활성화하여 시스템 로그에서 추가 디버깅 정보를 캡처합니다.
|
|
시스템 콘솔에서 연결 테스트 버튼을 선택하여 설정을 유효성 검사하고 사용자가 서버에 액세스할 수 있는지 확인합니다. |
이니셜 글꼴
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
자동 생성된 프로필 사진에서 사용되는 글꼴로, 색상 배경과 사용자 이니셜이 있습니다. 글꼴 파일 이름을 포함한 문자열입니다. 기본값은 nunito-bold.ttf 입니다. |
|
아마존 S3 요청 시간 초과
아마존 S3 저장소로의 요청이 타임아웃되기 전의 밀리초 단위 시간입니다. 기본값은 30000 (30초)입니다. |
|
이미지 프록시
모든 플랜 에서 사용 가능
self-hosted 배포판
이 메시지는 Mattermost 앱이 원격 자체 호스팅된 서버에 직접 연결하는 것을 방지하기 위해 이미지 프록시가 사용된다는 내용입니다. 이미지 프록시를 구성하려면 System Console > Environment > Image Proxy로 이동하거나 다음 표에 설명된 대로 config.json 파일을 편집하세요.
이미지 프록시 사용
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
이미지 프록시는 Mattermost 앱 연결을 익명화하고 보안되지 않은 콘텐츠에 액세스하는 것을 방지합니다.
|
|
이미지 프록시 설명서에서 자세히 알아보세요. |
이미지 프록시 유형
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
Mattermost가 사용하는 이미지 프록시의 유형입니다.
|
|
이미지 프록시 설명서에서 자세히 알아보세요. |
원격 이미지 프록시 URL
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
atmos/camo 프록시의 URL입니다. local 이미지 프록시를 사용할 때는 이 설정이 필요하지 않습니다. |
|
원격 이미지 프록시 옵션
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
atmos/camo 이미지 프록시에 전달되는 URL 서명 키입니다. local 이미지 프록시 유형을 사용할 때는 이 설정이 필요하지 않습니다. |
|
이미지 프록시 설명서에서 자세히 알아보세요. |
SMTP
모든 플랜 에서 사용 가능
self-hosted 배포판
Environment > SMTP 로 이동하여 시스템 콘솔 > 환경 > SMTP 를 편집하거나, 다음 표에 설명된 대로
config.json
파일을 수정하여 SMTP 이메일 서버 설정을 구성하세요.
SMTP 서버
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
이메일 알림에 사용되는 SMTP 이메일 서버의 위치입니다. |
|
SMTP 서버 포트
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
SMTP 이메일 서버의 포트입니다. 숫자 입력. |
|
SMTP 인증 활성화
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
SMTP 인증을 활성화하거나 비활성화합니다.
|
|
SMTP 서버 사용자 이름
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
SMTP 서버에 인증하기 위한 사용자 이름입니다. 문자열 입력. |
|
SMTP 서버 암호
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
SMTP 사용자 이름과 연결된 암호입니다. 문자열 입력. |
|
SMTP 연결 보안
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
SMTP를 사용하여 전송되는 이메일의 연결 보안을 지정합니다.
|
|
서버 인증서 확인 건너뛰기
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
Mattermost가 이메일 서버 인증서 확인을 건너뛸 수 있도록 구성합니다.
|
|
보안 경고 활성화
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
보안 경보를 활성화 또는 비활성화합니다.
|
|
자세한 내용은 Telemetry 문서를 참조하세요. |
SMTP 서버 시간 초과
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
Mattermost와 SMTP 서버 간에 TCP 연결을 설정하는 데 허용된 최대 시간(초)입니다. 숫자 값(초)입니다. |
|
푸시 알림 서버
모든 플랜 에서 사용 가능
self-hosted 배포판
매터모스트를 구성하여 시스템 콘솔 > 환경 > 푸시 알림 서버 로 이동하거나 다음 표에 설명된 대로 config.json
파일을 편집하여 매터모스트 클라이언트로의 푸시 알림을 활성화합니다. 이 섹션의 구성 설정을 변경하려면 서버를 다시 시작해야 합니다.
푸시 알림 활성화
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
매터모스트 푸시 알림을 활성화하거나 비활성화합니다.
|
|
참고 :
|
푸시 알림 서버 위치
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
매터모스트 호스팅된 푸시 알림 서비스(HPNS) 서버의 물리적 위치입니다. 미국 또는 (기본값) 독일 중에서 선택하여 푸시 알림 서버 필드 서버 URL을 자동으로 채울 수 있습니다. |
|
채널 당 최대 알림 수
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
성능을 최대화하기 위해 채널의 총 사용자 수가 @all, @here 및 @channel 에서 데스크톱, 이메일 또는 모바일 푸시 알림을 더 이상 보내지 않는 최대 수입니다. 숫자 입력. 기본값은 1000 입니다. |
|
참고 : 이 값을 조금씩 늘리고 성능 모니터링 지표 를 추적하여 시스템 상태를 모니터링한 후, 큰 채널에 읽기 전용 타운 스퀘어 채널과 같은 권한이 제한된 채널에서 누가 채널에 게시할 수 있는지를 제어하는 경우에만 이 값을 늘리도록 권장합니다. |
고가용성
Enterprise 플랜에서 사용 가능
self-hosted 배포판
시스템 콘솔에서 시스템 콘솔 > 환경 설정 > 고가용성 으로 이동하거나, 다음 표에 설명된 대로 config.json
파일을 편집하여 Mattermost를 고가용성 환경 으로 구성할 수 있습니다. 이 섹션의 구성 설정 변경은 적용되기 전에 서버를 다시 시작해야 합니다.
Mattermost 고가용성 클러스터 배포에서 시스템 콘솔은 읽기 전용으로 설정되어 있으며, 설정은 config.json
파일을 직접 편집하여 변경할 수 있습니다. 그러나 고가용성 환경을 테스트하려면 config.json
파일에서 ClusterSettings.ReadOnlyConfig
를 false
로 설정하여 비활성화할 수 있습니다. 이렇게 하면 시스템 콘솔을 통해 적용된 변경 사항을 구성 파일에 저장할 수 있습니다.
고가용성 모드 사용
이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.
고가용성 모드를 활성화할 수 있습니다.
|
|
Cluster name
이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.
고가용성 환경에서 이름으로 가입할 클러스터. 동일한 클러스터 이름을 가진 노드만 함께 가입합니다. 블루-그린 배포 또는 스테이징에서 동일한 데이터베이스를 가리키는 경우입니다. |
|
호스트 이름 재정의
이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.
이 서버의 호스트 이름을 재정의할 수 있습니다.
|
|
자세한 내용은 고가용성 클러스터 문서를 참조하십시오. |
IP 주소 사용
이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.
고가용성 환경에서 통신을 위해 호스트 이름 대신 IP 주소를 사용하도록 고가용성 환경을 구성할 수 있습니다.
|
|
Gossip 사용
이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.
모든 클러스터 트래픽은 gossip 프로토콜을 사용합니다.
|
|
참고 사항:
|
실험적인 Gossip 암호화 활성화
이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.
기본적으로 Gossip 암호화는 AES-256을 사용하며 이 값은 디자인상으로 구성할 수 없습니다.
|
|
참고 : 또는 시스템 테이블에서 |
Gossip compression 활성화
이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.
이 구성을 비활성화하는 것을 권장합니다. - true : **(자체 호스팅
|
|
Gossip port
이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.
Gossip 프로토콜에 사용되는 포트. UDP 및 TCP 모두이 포트에서 허용되어야합니다. 숫자 입력. 기본값은 8074 입니다. |
|
Streaming port
이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.
서버간 데이터 스트리밍에 사용되는 포트 숫자 입력. 기본값은 8075 입니다. |
|
읽기 전용 구성
이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.
|
|
네트워크 인터페이스
이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.
고가용성 클러스터에서 자동 IP 감지를 하는 기기를 식별하는 IP 주소입니다. 문자열 입력. |
|
바인드 주소
이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.
클러스터 트래픽을 특정 네트워크 장치에 바인딩하는 데 사용되는 IP 주소입니다. 문자열 입력. |
|
알림 주소
이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.
다른 노드에서 서버에 액세스하는 데 사용되는 IP 주소입니다. 클러스터 노드가 동일한 네트워크에 없고 NAT (네트워크 주소 변환) 이 포함되어 있을 때 주로 사용됩니다. 문자열 입력. |
|
고가용성을 위한 최대 idle 연결 수
이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.
클러스터 내에서 한 서버에서 다른 모든 서버로 유지 되는 최대 idle 연결 수입니다. 숫자 입력. 기본값은 100 입니다. |
|
Maximum idle connections per host
이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.
클러스터 내에서 한 서버에서 다른 서버로 유지되는 최대 아이들 연결 수. 숫자 입력. 기본값은 128 입니다. |
|
Idle connection timeout
이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.
클러스터 내 서버 간에 유지되는 아이들 연결을 유지하는 시간(밀리초). 숫자 입력. 기본값은 90000 입니다. |
|
속도 제한
모든 플랜 에서 사용 가능
self-hosted 배포판
레이트 제한은 Mattermost 서버가 너무 많은 요청으로 과부하되는 것을 방지하고, 제3자 애플리케이션 또는 악의적인 공격이 서버에 미치는 위험과 영향을 줄입니다. 시스템 콘솔 > 환경 > 레이트 제한 으로 이동하여 레이트 제한 설정을 구성하거나, 다음 표에 설명된 대로 config.json
파일을 편집합니다. 이 섹션의 구성 설정을 변경하려면 변경 사항이 적용되기 전에 서버를 다시 시작해야 합니다.
레이트 제한 활성화
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
특정 속도로 API를 제한하기 위해 레이트 제한을 활성화 또는 비활성화합니다.
|
|
초당 최대 쿼리 횟수
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
레이트 제한이 활성화된 경우 API를 초당 몇 번의 요청으로 제한합니다. 숫자 입력입니다. 기본값은 10 입니다. 이 값은 초당 요청 수를 늘리려면 더 많은 요청을 허용하도록 하거나, 값은 줄여 더 적은 요청을 허용하도록 합니다. |
|
최대 버스트 크기
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
레이트 제한이 활성화된 경우 초당 쿼리 제한을 초과하는 최대 수의 요청입니다. 숫자 입력입니다. 기본값은 100 입니다. 이 값을 늘리면 더 많은 동시 요청을 처리하도록 허용하고, 이 값을 줄이면 이 용량을 제한할 수 있습니다. |
|
메모리 저장소 크기
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
레이트 제한이 활성화된 경우 시스템에 연결된 최대 사용자 세션 수입니다. 숫자 입력입니다. 기본값은 10000 입니다. 일반적으로 시스템의 사용자 수로 설정됩니다. 이 값은 예상 사용자 수로 설정하는 것이 좋습니다. 더 높은 값은 자원의 낭비를 초래할 수 있으며, 더 낮은 값은 사용자 세션이나 토큰이 너무 자주 만료될 수 있습니다. |
|
원격 주소별 레이트 제한 다양화
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
레이트 제한이 활성화된 경우 IP 주소별로 API 액세스의 속도를 제한하도록 Mattermost를 구성합니다.
|
|
사용자별 레이트 제한 다양화
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
레이트 제한이 활성화된 경우 인증 토큰별로 API 액세스의 속도를 제한하도록 Mattermost를 구성합니다.
|
|
HTTP 헤더별 속도 제한 변경
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
Mattermost를 구성하여 지정된 HTTP 헤더 필드에 의해 API 액세스의 속도 제한을 변경할 수 있습니다. 프록시를 사용할 때 권장됩니다.
|
|
로깅
모든 플랜 에서 사용 가능
self-hosted 배포판
System Console > Environment > Logging 로 이동하여 또는 다음 표에 설명된 대로
config.json
파일을 편집하여 로깅을 구성하십시오. 이 섹션의 구성 설정을 변경하려면 서버를 다시 시작해야 적용됩니다.
Tip
Mattermost 알림에 대한 추가 로깅 구성을 NotificationLogSettings
아래의 config.json
파일에서 관리할 수 있습니다. 이러한 설정은 LogSettings
아래에서 사용 가능한 구성 설정과 동등합니다.
콘솔에 로그 출력
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
Mattermost를 콘솔에 로그를 출력하도록 구성합니다.
|
|
콘솔 로그 레벨
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
Mattermost가 로그 메시지를 콘솔에 출력할 때 쓰여지는 로그 이벤트의 상세 수준입니다.
|
|
콘솔 로그를 JSON으로 출력
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
Mattermost를 콘솔 로그를 JSON으로 출력하도록 구성합니다.
|
|
참고 : 일반적으로 운영 환경에서는 true 로 설정됩니다. |
일반 텍스트 콘솔 로그에 색상 적용
시스템 관리자가 일반 텍스트 로그 레벨 세부 정보에 색상을 표시할 수 있도록 합니다.
|
|
로그를 파일에 출력
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
Mattermost를 콘솔 로그를 파일에 출력하도록 구성합니다.
|
|
참고 : 일반적으로 운영 환경에서는 true 로 설정됩니다. |
파일 로그 디렉터리
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
로그 파일의 위치입니다. 문자열을 입력하세요. 로그 파일은 |
|
세션 길이
모든 플랜 에서 사용 가능
self-hosted 배포판
사용자가 로그인을 시도하면 사용자 세션이 지워지고, 세션은 24시간마다 세션 데이터베이스 테이블에서 지워집니다. 시스템 콘솔 > 환경 > 세션 길이 로 이동하여 세션 길이를 구성하거나, 다음 표에 설명된 대로 config.json
파일을 편집하여 세션 길이를 구성할 수 있습니다. 이 섹션의 구성 설정을 변경한 후에는 서버를 재시작해야 설정이 적용됩니다.
활동으로 세션 길이 연장
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
사용자가 Mattermost 앱에서 활동 중일 때 세션을 연장하여 사용자가 로그인한 상태를 유지하여 사용자 경험을 개선합니다.
|
|
AD/LDAP 및 이메일의 세션 길이
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
웹 앱 또는 데스크톱 앱에 마지막으로 사용자 자격 증명을 입력한 후 이메일 및 AD/LDAP 인증에서 사용자 세션이 만료될 때까지 계산된 시간 수를 설정합니다. 시간 단위의 숫자 입력. 기본값은 720 시간입니다. |
|
참고 : 이 설정을 변경한 후에는 새로운 세션 길이가 사용자가 다음으로 자격 증명을 입력한 후에 적용됩니다. |
모바일의 세션 길이
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
모바일 앱에 마지막으로 사용자 자격 증명을 입력한 후 사용자 세션이 만료될 때까지 계산된 시간 수를 설정합니다. 시간 단위의 숫자 입력. 기본값은 720 시간입니다. |
|
참고 : 이 설정을 변경한 후에는 새로운 세션 길이가 사용자가 다음으로 자격 증명을 입력한 후에 적용됩니다. |
SSO의 세션 길이
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
사용자가 SSO 자격 증명을 마지막으로 입력한 후 사용자 세션이 만료될 때까지 계산된 시간 수를 설정합니다. 이 설정은 SAML, GitLab 및 OAuth 2.0과 같은 SSO 인증에 대한 세션 길이를 정의합니다. 시간 단위의 숫자 입력. 기본값은 720 시간입니다. 이 구성 설정에 대해 소수점으로 된 숫자도 유효한 값입니다. |
|
참고 :
|
세션 캐시
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
메모리에 세션을 캐시하는 시간(분) 수를 설정합니다. 분 단위의 숫자 입력. 기본값은 10 분입니다. |
|
세션 유휴 시간
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
성능 모니터링
Enterprise 플랜에서 사용 가능
self-hosted 배포판
성능 모니터링을 구성하려면 시스템 콘솔 > 환경 > 성능 모니터링 으로 이동하거나, 다음 표에 설명된 대로 config.json
파일을 편집하세요. 이 섹션의 구성 설정을 변경하려면 서버를 다시 시작해야 합니다.
성능 모니터링 활성화
이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.
성능 모니터링을 활성화 또는 비활성화합니다.
|
|
더 알아보려면 성능 모니터링 설명서를 참조하세요. |
성능용 청취 주소
이 기능은 레거시 Mattermost Enterprise Edition E20에서도 사용할 수 있습니다.
활성화된 경우 Mattermost 서버가 성능 메트릭을 노출하기 위해 청취할 포트입니다. 숫자 입력. 기본값은 8067 입니다. |
|
개발자
모든 플랜 에서 사용 가능
self-hosted 배포판
시스템 콘솔 > 환경 > 개발자 로 이동하여 개발자 모드 구성, 또는 다음 표에 설명된대로
config.json
파일을 편집하여 개발자 모드를 구성합니다. 이 섹션의 구성 설정 변경은 적용되기 전에 서버를 재시작해야 합니다.
테스트 명령어 사용 가능 여부
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
|
|
개발자 모드 활성화
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
개발자 모드를 활성화 또는 비활성화합니다.
|
|
클라이언트 디버깅 활성화
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
개별 사용자를 위한 설정 > 고급 > 디버깅 에서 찾을 수 있는 클라이언트 측 디버깅 설정을 활성화 또는 비활성화합니다.
|
|
클라이언트 디버깅 설명서에서 자세한 내용을 확인하세요. |
신뢰되지 않는 내부 연결 허용
이 기능은 레거시 Mattermost Enterprise Edition E10 또는 E20에서도 사용할 수 있습니다.
Mattermost 서버가 로컬 네트워크 내에서 신뢰할 수 없는 요청을 수행하는 능력을 제한합니다. 클라이언트를 대표하여 수행되는 요청은 “신뢰할 수 없음”으로 간주됩니다. |
|
이 설정은 Mattermost 서버에서 요청할 수 있는 로컬 네트워크 주소의 화이트리스트입니다. 호스트 이름, IP 주소 및 액세스할 수 있는 CIDR 범위의 공백으로 구분된 목록으로 구성됩니다. 시스템 관리자만 구성할 수 있는 요청은 신뢰할 수 있으며이 설정에 영향을받지 않습니다. 신뢰할 수 있는 URL에는 OAuth 로그인이나 푸시 알림을 보내는 데 사용되는 URL 등이 포함됩니다. 다음 기능은 신뢰할 수 없는 요청을 수행하며이 설정에 영향을 받습니다.
|
|
이 설정을 수정해야 할 때의 몇 가지 예시는 다음과 같습니다.
|
|
경고: 이 설정은 로컬 네트워크 외부에 있는 사용자가 Mattermost 서버를 사용하여 로컬 네트워크에서 기밀 데이터를 요청하는 것을 방지하기 위해 만들어졌습니다. 이 설정을 구성할 때는 로컬 네트워크로의 부정한 액세스를 방지하기 위해 신중해야 합니다. |
|
참고 사항: - Mattermost 애플리케이션 서버 자체의 공용 IP도 예약된 IP로 간주됩니다. - 호스트 이름, IP 주소 또는 CIDR 범위를 나열할 때 쉼표 대신 공백을 사용하세요.
|