Guide

Operations Guide

Health checks, diagnostics, session handling, and rollout guardrails for running the plugin in production.

Health Checks

Use the admin diagnostics panel to inspect server health, version, agents, providers, active sessions, and recent bot synchronization state.

Session Management

The plugin keeps session mappings in the Mattermost plugin KV store. Admins can inspect active sessions, abort an active run, or reset a stored mapping when recovery is needed.

Error Handling

User-facing errors stay generalized while operational detail remains in logs and diagnostics. That keeps channel noise low without hiding useful debugging context from operators.

Logging

Keep usage logs enabled during rollout.
Enable debug logging only while troubleshooting.
Turn debug logging back off after gathering enough evidence.

Coding Bot Operations

Review command allowlists, channel restrictions, session reuse policy, and idle expiration closely. Also confirm the current OpenCode project is the one you expect before widening rollout.

Upgrade Checklist

Review release notes and configuration changes.
Upload the new tarball.
Run the connection test.
Verify one conversation bot and one coding bot end-to-end.

가이드

운영 가이드

프로덕션에서 플러그인을 운영할 때 필요한 health 확인, 진단, 세션 처리, 점진 배포 기준을 정리했습니다.

Health 확인

관리자 진단 화면에서 서버 health, 버전, agent, provider, 활성 세션, 최근 봇 동기화 상태를 확인합니다.

세션 관리

플러그인은 세션 매핑을 Mattermost 플러그인 KV 저장소에 보관합니다. 운영자는 활성 세션 조회, 실행 중단, 저장된 매핑 리셋을 통해 복구 작업을 할 수 있습니다.

오류 처리

사용자에게는 일반화된 실패 메시지를 보여주고, 자세한 운영 정보는 로그와 진단 화면에 남깁니다. 채널 소음을 줄이면서도 디버깅 정보는 잃지 않는 방식입니다.

로그 정책

도입 초기에는 usage log를 켜두는 편이 좋습니다.
debug log는 문제 추적 중에만 잠시 켭니다.
필요한 정보 확보 후에는 다시 끕니다.

코딩 봇 운영

명령 allowlist, 채널 제한, 세션 재사용 정책, idle 만료 기준을 특히 주의해서 봐야 합니다. 배포 범위를 넓히기 전에는 현재 OpenCode 프로젝트가 의도한 대상인지도 꼭 확인해야 합니다.

업그레이드 체크리스트

릴리즈 노트와 설정 변경점을 검토합니다.
새 tarball을 업로드합니다.
연결 테스트를 수행합니다.
대화 봇 1개, 코딩 봇 1개를 끝까지 검증합니다.