Ticketix はお使いのサーバー上で動作するため、正常な状態を保つためのツールがいくつか用意されています。いずれも管理者向けです。
場所: セットアップ → システム → ツール。メニューでは セットアップ → ツールと更新 です。セットアップのサブメニューの同じセクションに お知らせ、エクスポート、ライセンス もあります。
ツール画面
画面上部にはヘルスチェック(システムの状態)へのリンクがあります。各パネルは次のとおりです。
| パネル | 表示内容・機能 |
|---|---|
| 概要 | キュー内のメール、検索インデックスのサイズ、結果のなかった検索、PHP バージョン、データベースドライバー、IMAP および OpenSSL 拡張機能、upload_max_filesize、post_max_size、memory_limit、max_execution_time |
| メール | キュー内・送信済み・失敗したメール、SMTP と IMAP の有効状態、メールセンター へのリンク |
| 検索 | インデックスのレコード数、キューの保留数、候補。検索インデックスを再構築 でナレッジベース、コミュニティ、チケットのコンテンツのインデックスを再構築し、検索キューを処理 で待機中のインデックスジョブを処理します |
| ストレージ | 合計ストレージ、メール JSON ファイル、ログファイル、各ストレージフォルダーのパス・状態・サイズ・書き込み可否、メンテナンス操作 |
| ログ | system、mail、search、automation、cron など各ログの最新行と、各ログファイルのサイズおよび日時 |
| インスペクター | 管理者とエージェントのチケット範囲など、インストールの動作の簡単な概要 |
| システムチェック | データベースチェック、メールチェック、ストレージチェック、API チェック、キューチェック(それぞれ 実行 ボタン付き)。データは一切変更しません |
ストレージのメンテナンス
ストレージ パネルでは、各操作に専用の 実行 ボタンがあり、実行前に確認が求められます。
- フルメンテナンス は、孤立ファイルのクリーンアップ、古いメール JSON のクリーンアップ、古いログのクリーンアップをまとめて実行します。
- 孤立ファイルのクリーンアップ は、どのチケットでも使われていない添付ファイルを削除します。
- メール JSON のクリーンアップ は、30 日以上前のメールペイロードファイルを削除します。
ログ パネルの 古いログを削除 は、7 日以上前のログファイルを削除します。
これらの操作で削除されるのは作業用ファイルのみで、チケットとそのメッセージはデータベースに残ります。
チケットを完全に削除する
パネルの下にある チケットを完全に削除 は、チケットをそのメッセージ、添付ファイル、メール記録とともに完全に削除します。チケットを選択し、チケットを完全に削除 をクリックして確定してください。この操作は元に戻せません。エージェントは削除ではなくチケットをクローズします。
監視用のヘルスチェック
health.php は、Ticketix がインストールされているか、storage・添付ファイル・ログの各フォルダーに書き込みできるか、データベースが応答するか、スキーマが揃っているかを報告します。すべて正常な場合は JSON と HTTP ステータス 200 を、いずれかのチェックに失敗した場合は 503 を返します。
- サインイン中の管理者は、ツール 画面の システムの状態 から開けます。
- 監視サービスは、
config.phpのhealth_secretをX-Health-Secretヘッダーで送信します(例:https://support.example.com/health.php宛て)。
有効なシークレットまたは管理者セッションがない場合、health.php は「Not found」と応答します。
サーバー上でのセキュリティチェック
基本的なセキュリティ設定を確認するには、アプリケーションフォルダーで次のコマンドを実行します。
php scripts/security-preflight.php
デバッグモードがオフであること、config.php のシークレットが十分に強力であること、config.php と .htaccess が存在すること、storage フォルダーが保護されていることを確認します。すべてのチェックに合格すると、結果は "ok": true を含む JSON になります。
Ticketix をバックアップする
以下の項目を定期的に、また更新の前には必ず、アクセスが制限された場所にバックアップしてください。
| 項目 | 理由 |
|---|---|
| データベース | チケット、顧客、記事、設定(SQLite の場合、データベースファイルは storage フォルダー内にあります) |
config.php | データベースの接続情報とインストールのシークレット |
storage フォルダー | 添付ファイル、ナレッジベースの画像、ログ、ライセンスファイル、ai-secret.key |
storage/ai-secret.key は、保存された AI プロバイダーのキーと認証アプリのシークレットを暗号化します。このファイルがないと、AI キーを再入力し、二要素認証をリセットする必要があります。
データを持ち運べる形で保存したい場合、管理者は セットアップ → システム → エクスポート から フルパッケージ をダウンロードすることもできます。レポート、繰り返し発生する問題、エクスポートをご覧ください。
復元するには、アプリケーションファイル、config.php、storage フォルダー、データベースをまとめて元に戻します。