지원 패킷은 고객의 문제를 진단하고 해결하는 데 사용됩니다. System Console 또는 mmctl system supportpacket 명령을 사용하여 고가용성 클러스터의 모든 노드에 걸친 설정 정보, 로그, 플러그인 세부 정보, 외부 의존성 데이터를 포함하는 zip 파일을 생성합니다. 비밀번호와 같은 기밀 데이터는 자동으로 제거됩니다.

생성#

go run ./cmd/mmctl system supportpacket

Downloading Support Packet
 Downloaded Support Packet to mattermost_support_packet_.zip</code></pre>
<h2 id="기밀-데이터-익명화">기밀 데이터 익명화</h2>

<p>패킷을 Mattermost와 공유하기 전에 제외하고 싶은 기밀 데이터를 익명화하세요.


다음 정보는 패킷 생성 중 자동으로 익명화됩니다: LdapSettings.BindPassword, FileSettings.PublicLinkSalt, FileSettings.AmazonS3SecretAccessKey, EmailSettings.SMTPPassword, GitLabSettings.Secret, GoogleSettings.Secret, Office365Settings.Secret, OpenIdSettings.Secret, SqlSettings.DataSource, SqlSettings.AtRestEncryptKey, ElasticsearchSettings.Password, All SqlSettings.DataSourceReplicas, All SqlSettings.DataSourceSearchReplicas, MessageExportSettings.GlobalRelaySettings.SmtpPassword, ServiceSettings.SplitKey, FileSettings.ExportAmazonS3SecretAccessKey, ElasticsearchSettings.ClientKey, ServiceSettings.GoogleDeveloperKey, ServiceSettings.GiphySdkKey (Mattermost v11.6.0부터).

Important
패킷 생성 중 플러그인은 익명화되지 않을 수 있습니다.
Mattermost v10.1부터 플러그인은 설정을 숨김으로 표시할 수 있습니다. 플러그인이 설정을 숨김으로 표시하면 패킷 생성 중 설정이 익명화됩니다.
그렇지 않은 경우, Mattermost와 공유하기 전에 plugin.json 파일에서 추가 기밀 세부 정보를 직접 익명화하세요. 가능하면 같은 특수 문자가 포함된 예시 문자열로 세부 정보를 교체하세요. 특수 문자는 설정 오류의 일반적인 원인이기 때문입니다.
Mattermost와 패킷 공유#

생성된 지원 패킷을 표준 지원 요청 에 첨부하거나 함께 작업 중인 Mattermost 팀과 공유하세요.

Important
지원 패킷을 생성한 후에는 디버그 로깅을 비활성화하세요. 디버그 로깅은 로그 파일을 크게 증가시킬 수 있으며 서버 성능에 부정적인 영향을 줄 수 있습니다. 임시로 또는 개발 환경에서만 활성화하고, 프로덕션 환경에서는 활성화하지 않는 것을 권장합니다.
지원 패킷 내용#

Mattermost 지원 패킷의 내용은 서버 버전에 따라 다를 수 있습니다. Mattermost 버전에 해당하는 탭을 선택하여 지원 패킷에 포함된 파일을 확인하세요.

v11.0 and laterv10.11v10.10v10.5 to v10.9Prior to v10.5


클러스터 전체 파일#

다음 클러스터 전체 파일은 지원 패킷의 루트 디렉터리에 있습니다:

metadata.yaml
plugins.json (모든 활성 및 비활성 플러그인)
sanitized_config.json (Mattermost 설정의 익명화된 복사본)
stats.yaml (Mattermost 사용 통계)
jobs.yaml (중요 작업의 마지막 실행)
diagnostics.yaml (시스템 및 플러그인 진단)
permissions.yaml (역할 및 스키마 정보)
postgres_schema_dump.sql (테이블, 인덱스, 제약 조건 및 기타 메타데이터를 포함한 PostgreSQL 데이터베이스 스키마 정보)
warning.txt (패킷 생성 중 문제 발생 시 존재)
tsdb_dump.tar.gz (Metrics 플러그인이 설치되어 있고 지원 패킷 생성 시 Performance metrics 옵션을 선택한 경우 존재)

노드별 파일#

다음 노드별 파일은 노드 하위 디렉터리에 있습니다:

<node-id>/mattermost.log (각 노드의 Mattermost 로그)
<node-id>/audit.log (각 노드의 Mattermost 감사 로그)
<node-id>/ldap.log (각 노드의 AD/LDAP 로그)
<node-id>/notifications.log (각 노드의 알림 로그)
<node-id>/cpu.prof (각 노드의 Go 성능 메트릭)
<node-id>/heap.prof (각 노드의 Go 성능 메트릭)
<node-id>/goroutines (각 노드의 Go 성능 메트릭)

진단 하이라이트#

지원 패킷 diagnostics.yaml 파일에는 문제 해결 및 설정 검증을 지원하는 시스템 및 플러그인 진단이 포함되어 있습니다.

플러그인 진단 데이터#

플러그인이 활성화되어 작동 중일 때 다음 추가 플러그인 진단 데이터를 사용할 수 있습니다:

GitHub: /github/diagnostics.yaml
GitLab: /com.github.manland.mattermost-plugin-gitlab/diagnostics.yaml
Jira: /jira/diagnostics.yaml
Calls: /com.mattermost.calls/diagnostics.yaml
Boards: /focalboard/diagnostics.yaml
Playbooks: /playbooks/diagnostics.yaml
MSCalendar: /com.mattermost.mscalendar/diagnostics.yaml
Google Calendar: /com.mattermost.gcal/diagnostics.yaml




v10.11부터 지원 패킷에는 데이터베이스 설정 문제, 성능 문제, 정렬 불일치 및 기타 데이터베이스 관련 문제를 진단하는 데 도움이 되는 포괄적인 메타데이터를 제공하는 PostgreSQL 데이터베이스 스키마 덤프 정보가 포함됩니다.

클러스터 전체 파일(루트 디렉터리):

metadata.yaml
plugins.json (모든 활성 및 비활성 플러그인)
sanitized_config.json (Mattermost 설정의 익명화된 복사본)
stats.yaml (Mattermost 사용 통계)
jobs.yaml (중요 작업의 마지막 실행)
diagnostics.yaml (핵심 플러그인 진단 데이터)
permissions.yaml (역할 및 스키마 정보)
postgres_schema_dump.sql (테이블, 인덱스, 제약 조건 및 기타 데이터베이스 메타데이터를 포함한 PostgreSQL 데이터베이스 스키마 정보)
warning.txt (패킷 생성 중 문제 발생 시 존재)
tsdb_dump.tar.gz (Metrics 플러그인이 설치되어 있고 지원 패킷 생성 시 Performance metrics 옵션을 선택한 경우 존재)

클러스터별 파일(노드 하위 디렉터리):

<node-id>/mattermost.log (각 노드의 Mattermost 로그)
<node-id>/audit.log (각 노드의 Mattermost 감사 로그)
<node-id>/ldap.log (각 노드의 AD/LDAP 로그)
<node-id>/notifications.log (각 노드의 알림 로그)
<node-id>/cpu.prof (각 노드의 Go 성능 메트릭)
<node-id>/heap.prof (각 노드의 Go 성능 메트릭)
<node-id>/goroutines (각 노드의 Go 성능 메트릭)

플러그인이 활성화되어 작동 중일 때 생성된 지원 패킷에 다음 추가 플러그인 진단 데이터가 포함됩니다:

GitHub: /github/diagnostics.yaml
GitLab: /com.github.manland.mattermost-plugin-gitlab/diagnostics.yaml
Jira: /jira/diagnostics.yaml
Calls: /com.mattermost.calls/diagnostics.yaml
Boards: /focalboard/diagnostics.yaml
Playbooks: /playbooks/diagnostics.yaml
MSCalendar: /com.mattermost.mscalendar/diagnostics.yaml
Google Calendar: /com.mattermost.gcal/diagnostics.yaml




Mattermost v10.10부터 고가용성 배포의 지원 패킷은 클러스터별 파일(예: 로그 파일)을 각 클러스터 노드의 이름을 따라 하위 디렉터리에 정리하고, 클러스터 전체 파일은 루트 디렉터리에 남겨둡니다.

지원 패킷 파일 구성이 개선되어 클러스터 전체 파일과 클러스터별 파일을 더 쉽게 식별할 수 있습니다:

클러스터 전체 파일 (고가용성 클러스터 의 모든 노드에서 동일한 파일)은 지원 패킷의 루트 디렉터리에 남아 있습니다.
클러스터별 파일 (노드당 고유한 파일)은 이제 각 클러스터 노드의 이름을 따라 하위 디렉터리에 정리됩니다.

클러스터 전체 파일(루트 디렉터리):

metadata.yaml
plugins.json (모든 활성 및 비활성 플러그인)
sanitized_config.json (Mattermost 설정의 익명화된 복사본)
stats.yaml (Mattermost 사용 통계)
jobs.yaml (중요 작업의 마지막 실행)
diagnostics.yaml (핵심 플러그인 진단 데이터)
permissions.yaml (역할 및 스키마 정보)
warning.txt (패킷 생성 중 문제 발생 시 존재)
tsdb_dump.tar.gz (Metrics 플러그인이 설치되어 있고 지원 패킷 생성 시 Performance metrics 옵션을 선택한 경우 존재)

클러스터별 파일(노드 하위 디렉터리):

<node-id>/mattermost.log (각 노드의 Mattermost 로그)
<node-id>/audit.log (각 노드의 Mattermost 감사 로그)
<node-id>/ldap.log (각 노드의 AD/LDAP 로그)
<node-id>/notifications.log (각 노드의 알림 로그)
<node-id>/cpu.prof (각 노드의 Go 성능 메트릭)
<node-id>/heap.prof (각 노드의 Go 성능 메트릭)
<node-id>/goroutines (각 노드의 Go 성능 메트릭)

플러그인이 활성화되어 작동 중일 때 생성된 지원 패킷에 다음 추가 플러그인 진단 데이터가 포함됩니다:

GitHub: /github/diagnostics.yaml
GitLab: /com.github.manland.mattermost-plugin-gitlab/diagnostics.yaml
Jira: /jira/diagnostics.yaml
Calls: /com.mattermost.calls/diagnostics.yaml
Boards: /focalboard/diagnostics.yaml
Playbooks: /playbooks/diagnostics.yaml
MSCalendar: /com.mattermost.mscalendar/diagnostics.yaml
Google Calendar: /com.mattermost.gcal/diagnostics.yaml




v10.10 이전에는 고가용성 배포의 클러스터에 있는 각 노드가 지원 패킷에 직접 포함된 자체 mattermost.log 파일과 고급 로깅 파일을 가지고 있습니다.

v10.5부터 다음 지원 패킷 데이터가 변경되었습니다:

support_packet.yaml 파일이 제거되고 diagnostics.yaml 와 stats.yaml 파일로 분리되었습니다.
diagnostics.yaml 의 모든 필드가 가독성 향상을 위해 각자의 객체로 이동되었습니다.
필드 이름이 정규화되었습니다.
서버 통계, 로그, 권한, 확장된 작업 목록 세부 정보를 포함하는 새로운 데이터가 추가되었습니다.
해당하는 경우 Mattermost 지원 플러그인 진단 데이터가 포함됩니다.

지원 패킷의 내용에는 다음이 포함됩니다:

metadata.yaml
mattermost.log (Mattermost 로그)
audit.log (Mattermost 감사 로그)
ldap.log (AD/LDAP 로그)
notifications.log (알림 로그)
plugins.json (모든 활성 및 비활성 플러그인)
sanitized_config.json (Mattermost 설정의 익명화된 복사본)
stats.yaml (Mattermost 사용 통계)
jobs.yaml (중요 작업의 마지막 실행)
diagnostics.yaml (핵심 플러그인 진단 데이터)
permissions.yaml (역할 및 스키마 정보)
Go 성능 메트릭 (포함: cpu.prof, heap.prof, goroutines)
warning.txt (패킷 생성 중 문제 발생 시 존재)
tsdb_dump.tar.gz (Metrics 플러그인이 설치되어 있고 지원 패킷 생성 시 Performance metrics 옵션을 선택한 경우 존재)

플러그인이 활성화되어 작동 중일 때 생성된 지원 패킷에 다음 추가 플러그인 진단 데이터가 포함됩니다:

GitHub: /github/diagnostics.yaml
GitLab: /com.github.manland.mattermost-plugin-gitlab/diagnostics.yaml
Jira: /jira/diagnostics.yaml
Calls: /com.mattermost.calls/diagnostics.yaml
Boards: /focalboard/diagnostics.yaml
Playbooks: /playbooks/diagnostics.yaml
MSCalendar: /com.mattermost.mscalendar/diagnostics.yaml
Google Calendar: /com.mattermost.gcal/diagnostics.yaml




Mattermost v10.4부터 새 diagnostics.yaml 파일에는 플러그인 버전, 통화 및 활성 세션 수, 평균 통화 시간과 참여자 수를 포함한 Mattermost Calls 진단 데이터가 포함됩니다.

metadata.yaml
mattermost.log
plugins.json
sanitized_config.json
support_packet.yaml
diagnostics.yaml (핵심 플러그인 진단 데이터)
Go 성능 메트릭 (포함: cpu.prof, heap.prof, goroutines)
warning.txt (패킷 생성 중 문제 발생 시 존재)



Note
LDAP 그룹은 지원 패킷 생성 중 포함되지 않습니다. 존재하는 경우 LDAP Version 과 LDAP Vendor 만 포함됩니다. 이 값들은 support_packet.yaml 파일에 포함됩니다.

Mattermost v9.11부터 LDAP Vendor 오류가 지원 패킷에 포함됩니다. LDAP 공급업체 이름 가져오기에 실패하면 지원 패킷 생성 시 warning.txt 에 오류가 포함됩니다. LDAP 공급업체 이름을 찾을 수 없는 경우 지원 패킷에서 unknown 으로 나열됩니다.

메타데이터#

Mattermost v9.11부터 생성된 지원 패킷에는 다음 정보가 포함된 metadata.yaml 파일이 포함됩니다.

필드명
필수/선택
설명
예시
version
필수
현재 메타데이터 파일이 호환되는 스키마 버전. 현재 버전은 1입니다.
1
type
필수
패킷의 유형. 각 지원 패킷 유형은 패킷을 생성하는 특정 컴포넌트에 매핑될 수 있습니다.
mattermost
generated_at
필수
패킷이 생성된 날짜와 시간. 값은 에포크(ms) 형식입니다.
1707473288731
server_version
필수
지원 패킷이 생성된 서버 버전. Semver가 예상됩니다.
9.1.1
server_id
필수
서버의 고유 식별자. 26자 이상이어야 합니다.
9qpiszyjr3g8bxda35abcd1234
license_id
선택
현재 서버 라이선스의 고유 식별자. 26자 이상이어야 합니다. 라이선스가 없으면 이 필드는 비어 있습니다.
abcdejisd67yigqhmkz4ho1234
customer_id
선택
라이선스 파일에 정의된 고객 ID. 26자 이상이어야 합니다. 라이선스가 없으면 비어 있습니다.
a1b2c3d4qbbr5cpkbpbmef123h
extras
선택
파일을 생성한 플러그인/컴포넌트에 특정한 추가 정보의 키/값. 데이터 내용을 식별하는 데 유용할 수 있습니다. 이 객체의 내용에 대한 기대치 설정을 위해 플러그인(또는 컴포넌트) 버전 추가를 고려하세요.
extras.plugin_id
플러그인의 경우 필수
플러그인의 ID.
extras.plugin_version
플러그인의 경우 필수
플러그인의 버전.


예시:

:class: mm-code-block
version: 1
type: support-packet
generated_at: 1622569200
server_version: 9.1.1
server_id: 8fqk9rti13fmpxdd5934a3xsxh
license_id: 3g3pqn8in3brzjkozcn1kdidgr
customer_id: 74cmws7gf3ykpj31car7zahsny
extras:
plugin_version: 0.1.0

<h2 id="go-성능-메트릭">Go 성능 메트릭</h2>

<p>지원 패킷에는 3개의 Go 런타임 프로파일링 파일이 포함됩니다:


cpu.prof 에는 5초 CPU 프로파일이 포함됩니다.
heap.prof 에는 힙 프로파일이 포함됩니다.
goroutines 에는 실행 중인 모든 Go 루틴의 덤프가 포함됩니다.

이 파일들은 pprof 를 사용하여 읽을 수 있습니다.

go tool pprof -web X 를 사용하여 브라우저에서 프로파일 시각화를 열 수 있으며, X 를 프로파일의 파일 이름으로 교체하세요.

로드 메트릭#

Mattermost v10.10부터 제품 메뉴 > Mattermost 정보 아래의 Load Metric 필드에 총 라이선스 사용자 수 대비 월간 활성 사용자 수가 표시됩니다. 이 값은 Mattermost 지원팀이 문제 해결 및 안내를 위해 배포 활성 사용량에 대한 맥락적 참조 지점을 제공합니다. 포괄적인 성능 모니터링 도구나 상태 지표가 아니라, 전통적인 진단 방법을 사용할 수 없는 경우 보조적인 데이터 포인트로 활용됩니다.