このページはCalíope 1.7を紹介しています。私がいま作っているバージョンです。1.6は、Mac、iPad、iPhone、Apple Watch、Apple TV、Apple Vision Pro向けにApp Storeで公開中です。それぞれの機能がどのバージョンで入ったかは変更履歴に書いてあります。

すべてのトピックに「Calíopeで開く」ボタンを追加します。アプリがインストールされている場合にのみ機能します。

ほかのデバイスのCalíope

Apple TVのCalíope:サーバ群のダッシュボード

何が表示されるか、何かを表示させるためにこちらで何をオンにするか、そして電源の切れたMacが画面を緑のままにしない理由。

場所: Calíope › 設定 › 一般

Apple TVでは、Calíopeは読むだけです。別のアプリではありません。同じApp Storeのページ、同じ購入で、Apple TVにもインストールされます。接続を開かず、クエリーを実行せず、サーバに触れることもありません。Calíopeがこのコンピュータから測定してiCloudに公開したものを、ダッシュボードとして表示します。

こちらでオンにするもの(この順で)
1. 「ヘルスモニタ」を設定して動かし、見たいサーバを登録します。数値を生み出すのはこれで、これがなければ公開するものがありません。
2. 「設定」›「一般」›「Apple TV」›「サーバの状態をiCloudに公開」。最初はオフです。

そして、Apple TVがこのコンピュータと同じiCloudアカウントにサインインしていること。

このコンピュータから出ていくもの
監視している各サーバのエイリアス、ホスト、ポート、エンジン、バージョン、指標です。パスワードやクエリーの内容は決して含まれません。スイッチをオフにすると、すでに公開したものは削除されます。古い数値を表示したまま残しておくことはしません。

「トポロジ」で宣言したレプリケーショングループはテレビには届きません。ヘルスモニタが監視している各メンバーは、レプリカの遅延を持つサーバの1つとして表示されます。

テレビがそれ以上できない理由
tvOSにはiCloud DriveもiCloudキーチェーンもありません。接続プロファイルもパスワードもこのデバイスには決して届かないので、「読むだけ」はアプリの行儀の良さに頼っているのではなく、プラットフォームが支えています。

電源の切れたMacは画面を緑のままにしない
各サーバは公開されたときの更新間隔と一緒に届き、鮮度はテレビ自身が計算します。数値がその更新間隔の3倍を超えて更新されないと(下限は90秒)、現在の値としては表示されなくなります。15秒ごとのポーリングなら45秒、5分ごとなら15分保ちます。上限があなたの設定から導かれるのは、公開していた側には自分が公開をやめたことがわからないからです。

しきい値はCalíopeが決める
何を赤とし何を琥珀色とするかは、サーバと資格情報がある場所で決まります。テレビではありません。テレビは塗るだけです。同じ理由で、状態を色だけで区別することはありません。重大度ごとに独自の形も付くので、4メートル離れていても、赤と緑を見分けられなくても、ダッシュボードを読めます。

画面が空の場合
テレビは6つの原因を区別し、それぞれどのデバイスで直すかを示します:iCloudアカウントがない、テレビでiCloudが制限されている、Calíopeが一度も公開していない、公開しているがサーバを監視していない、問い合わせができない、ネットワークが失敗した。2つはこちらで、2つはテレビで直し、最後の2つはどちらでもありません。iCloudのコンテナかネットワークの問題です。また、いつでもデモを表示できるので、データがあればダッシュボードがどう見えるかを確認できます。

テレビの3つの設定(デモ、画面をスリープさせない、言語)は、そのApple TVのもので、外に出ることはありません。

Apple TVのトップ列で
ホーム画面のトップ列にCalíopeを置くと、そのアイコンに移動したときに大きな帯が表示されます。Calíopeが公開しているサーバのうち最大12台が緊急度の高い順に並び、その後にcaliope.orgのデモ動画(サイトと同じもので、英語の字幕付き)が続きます。各カードには、現在の時刻ではなく公開された時刻が表示されます。カードを選ぶとアプリでそのサーバの詳細が開き、動画を選ぶと「ダッシュボード」が開きます。アプリを「設定」で終えていた場合は、そこが開きます。Calíopeが公開していない場合や、テレビがiCloudにサインインしていない場合、帯には動画だけが表示されます。

キーワード: Apple TV、テレビ、TV、Calíope TV、サーバ群、ダッシュボード、ヘルス、モニタ、公開、iCloud、デバイス

Apple WatchのCalíope:システムメッセージを手首に

あなたが見ていないあいだにCalíopeが記録したことの受信箱を読みます。こちらに2つのスイッチ、Apple Watchに2つのアクセス権があります。

場所: Calíope › 設定 › 一般

Apple Watchでは、Calíopeは読むだけです。別のアプリではありません。iPhoneのアプリに含まれ、同じApp Storeのページ、同じ購入で手に入ります。ただし、単独でインストールされ、近くにiPhoneがなくても動作します。読むだけで、読むのはあなたが見ていないあいだにCalíopeが記録するシステムメッセージです:終わったり失敗したりしたバックアップ、復元、レポート、実行が長引いたり多すぎる結果を返したりしたクエリー、切れては戻るSSHトンネル、しきい値に近づいたサーバ。

こちらでオンにするもの
どちらも「設定」›「一般」›「システムメッセージ」にあり、両方が必要です:
1. 「システムメッセージを記録」 — これがなければ読むものがありません。
2. 「メッセージをiCloudと同期」 — これがなければ、メッセージはこのコンピュータから出ていきません。最初はオフです。

このコンピュータから出ていくのは、プロファイルまたはサーバのエイリアス、バックアップ、復元したファイル、レポートの名前、それを生み出したマシン、そしてメッセージの中の数値(秒数、行数、パーセント)です。ホスト、ポート、ユーザ、クエリーのテキストは決して含まれません。

Apple Watchには2つのアクセス権があり、同じものではありません
アプリを開いたときに受信箱を読むことと、午前3時に手首を震わせることは、同じ許可ではありません。「iCloud」のアクセス権はApple Watchに読むことを許し、「アラート」のアクセス権は割り込むことを許します。このシステムのアクセス権は、オンにしたその時に求められます。アプリが何のために使うのかを説明できるのは、その瞬間だけだからです。どちらも最初はオフです。

アラートはメッセージの種類ではなくグループで絞り込む
19個ではなく7個のスイッチです。40 mmの画面では、スクロールする一覧と諦める一覧の違いになります。また、時が経っても破綻しません。新しい種類のメッセージは、すでに決めたグループのどれかに入ります。誰も知らないうちにオンの状態で現れることはありません。そして、Apple Watchが名前を付けられないものは常に表示されます。別の設定「通知の対象」で、どの重大度からApple Watchが音を鳴らすかを決めます。

どのくらいの頻度で確認するか、そしてそれが最短である理由
アプリを開いているときは、選んだ間隔(1、5、15、30、60分)が守られます。アプリを閉じているときは約束ではありません。watchOSは独自の予算(バッテリー、使用状況、文字盤に表示されているかどうか)で起動の機会を配分し、実際には1時間に1回程度です。選んだ数値は、要求できる最短の間隔であって、実際に起こるタイミングではありません。だから出荷時の値は1分ではなく15分です。

起動の機会を逃してもアラートは失われません。Apple Watchは、直近の15分間だけでなく、すでに知らせた最後のメッセージより後のものをすべて届けます。

初回に100件が届くことはない
アラートをオンにすると、最初のサイクルは何も通知せず、受信箱の現在位置を記録するだけです。何か月分もの履歴がある状態でオンにしたら、必要以上に割り込まないことにすべての価値があるものにとって、最悪の第一印象になります。そしてオフにするとその印が忘れられるので、1か月後にオンに戻しても、その1か月分が届くことはありません。

Apple Watchがこのコンピュータと違う言語になっていても問題ありません。むしろそれが普通です。メッセージは翻訳されずに届き、文は手首の上で組み立てられます。

キーワード: Apple Watch、Calíope Watch、手首、メッセージ、通知、アラート、watchOS、受信箱、デバイス

iPhoneのCalíope

MacやiPadと同じアプリが、ポケットに入ります。接続し、クエリーを実行し、ほかのデバイスが公開したものを読みます。

場所: Calíope › 設定 › 一般

iPhoneではCalíopeそのものが動きます。別のアプリではありません。同じApp StoreのページからMac、iPad、iPhone、Apple Vision Proにインストールされ、1回の購入ですべてに使えます。データベースに接続し、クエリーを実行し、同じツールを使えます。iPhoneの画面に合わせた形で。

ほかのコンピュータと共有するもの
MacとiPadのあいだで同期されるものは、同じスイッチでiPhoneにも同期されます。「iPhone用」のスイッチはありません:
- 接続、SQLスニペット、設定。「CalíopeをiCloudと同期」で同期します。パスワードはiCloudキーチェーンを通じて別に同期されます。
- クエリー履歴 — スイッチはSQLログの、そのツール自身のバーにあります。
- AIアシスタントの会話 — スイッチはアシスタントのパネルにあります。
- アプリのエラーログ — 「設定」›「一般」›「エラーログをiCloudと同期」。
- システムメッセージ — 「設定」›「一般」›「メッセージをiCloudと同期」。

そして、iPhoneで編集したものはこちらにも表示されます。接続のファイルには意図して複数の書き手がいます。だから置き換えずに結合します。あるデバイスがプロファイルについて理解できない部分も失われません。

iPhoneのヘルプはこのヘルプです。同じアプリなので、ヘルプも同じです。いま読んでいる内容は、iPhoneでも同じように読めます。

キーワード: iPhone、電話、モバイル、ポケット、接続、スニペット、デバイス、通知、同期

各デバイスに届くもの

Apple TVに見えるもの、Apple Watchに見えるもの、iPhoneに見えるものを1つずつ。そして、決して見えないもの。

場所: Calíope › 設定 › 一般

このトピックは受け取る側のデバイスから見ています:Apple TVをつけたとき、あるいは手首を上げたとき、何が見えるはずでしょうか。このコンピュータから何が出ていくか(どの仕組みで、どのスイッチで)は「同期されるものとその仕組み」にあります。同じ問いを両端から見ており、どちらの一覧ももう一方を繰り返していません。

すべてに共通する3つの条件
- 両方のデバイスが同じiCloudアカウントであること。
- チャネルごとにスイッチがあり、どれも最初はオフです。「CalíopeをiCloudと同期」をオンにしても、どれもオンにはなりません。それぞれ別の同意であり、1つの同意の段階ではありません。
- Macだけでなく、Calíopeを動かしているどのコンピュータも公開します。iPad、iPhone、Apple Vision Proも公開し、どのタブも開いておく必要はありません。必要なのは、そのコンピュータがスイッチを入れた状態で少なくとも一度起動していることです。

Mac、iPad、iPhone、Apple Vision Proは、ほとんどすべてを伝え合います。接続プロファイル、SQLエディタのタブ、ヘルスモニタの設定、保存したスニペット、設定。そして、それぞれのスイッチをオンにすれば、クエリー履歴、アシスタントの会話、アプリのエラーログ、システムメッセージも。パスワードはiCloudキーチェーンを通じて別に同期されます。

Apple TVでCalíopeに見えるのは、ちょうど1つだけです:ヘルスモニタが監視しているサーバの状態です。クエリーもバックアップもレポートもメッセージも見えません。「設定」›「一般」›「Apple TV」の「サーバの状態をiCloudに公開」でオンにします。そして、スイッチと何かを監視しているモニタの両方が必要です。スイッチだけでは空の一覧が公開されるからです。

Apple WatchでCalíopeに見えるのも、ちょうど1つだけです:システムメッセージです。「設定」›「一般」›「システムメッセージ」の「メッセージをiCloudと同期」でオンにし、Apple Watch自体でiCloudのアクセス権を許可します(最初はオフです)。Apple Watchにはサーバもクエリーも接続も見えません。

iPhoneではCalíopeはアプリ全体です。読むだけのデバイスではなく、Calíopeを動かすコンピュータの1台です。MacやiPadと同じもの(接続とSQLスニペット、クエリー履歴、アシスタントの会話、アプリのエラーログ、システムメッセージ)が同じスイッチで見え、「iPhone用」のスイッチはありません。そして、接続してクエリーを実行することもできます。これはテレビとApple Watchが決してしないことです。

どのデバイスにも届かないもの:バックアップとレポートの実行履歴は、実行したコンピュータに残ります。どのチャネルも公開しないので、このコンピュータから出ていきません。これは想定どおりで、不具合ではありません。

そして、決して出ていかないもの(何をオンにしていても):キーチェーンの外のパスワードとSSHキー、診断ログ、自動補完のためのスキーマのキャッシュ、そしてmacOSが許可したファイルのアクセス権(許可したコンピュータでしか有効ではありません)。クエリーのテキストはテレビにもApple Watchにも決して届きません。Calíopeを動かしているあなた自身のデバイス(Mac、iPad、iPhone、Apple Vision Pro)のあいだだけで、専用のスイッチで同期されます。

キーワード: デバイス、届くもの、見えるもの、Apple TV、Apple Watch、iPhone、コンパニオン、iCloud、チャネル、スイッチ、同期、公開

システムメッセージ

あなたが見ていないあいだにCalíopeが行ったことや検知したことの記録:何が記録されるか、どれだけ保持されるか、何がこのコンピュータの外に出るか。

場所: Calíope › 設定 › 一般

問題なく終わった夜間のバックアップ、失敗した定期レポート、午前4時に切れて自然に戻ったSSHトンネル、接続数のしきい値に迫ったサーバ。どれも誰も見ていないときに起きることです。以前は一度見たら終わりの通知としてしか存在せず、跡が残りませんでした。システムメッセージはその跡です。

ほかの2つとは別のログです。アプリのエラーログはアプリに起きたことを、実行履歴は実行されたものを保持します。こちらは通知そのものを保持します。

記録されるもの。7つのグループ(バックアップ、レポート、クエリー、接続、サーバ、同期、アプリ自体)にまたがる19種類の通知です。それぞれに重大度(情報、成功、警告、エラー)と、あればその裏付けとなる数値(かかった秒数、返した行数、達したパーセント)が付きます。

2つのスイッチは独立しています。「設定」›「一般」›「システムメッセージ」にあります:
- 「システムメッセージを記録」は、メッセージをこのコンピュータに保持します。これがなければ同期するものがないので、2つ目のスイッチは無効になります。
- 「メッセージをiCloudと同期」は、メッセージを公開します。最初はオフです。バックアップ名、レポート名、プロファイルのエイリアスをここから外に出すことは、別に求める許可だからです。オフにするとき、CalíopeはiCloudのコピーを残すか(「オフにしてiCloudのコピーを残す」)、すべてのデバイスから削除するか(「オフにしてiCloudのコピーを削除」)を尋ねます。

保持される期間。「ログの保持期間」で30、90、180、365日、または無制限を選べます。出荷時の設定は90日です。削除は両方の場所で本当に行われます。1日に1回、ここで削除し、そしてiCloudでも削除します。クラウドにコピーを残す削除は、次の同期でそれをまた取り戻してしまうので、選択肢がないよりも悪いのです。

出ていくもの、そして届く言語。出ていくのは、プロファイルまたはサーバのエイリアス、バックアップ、復元したファイル、レポートの名前、どのコンピュータで生じたか、そして通知の中の数値です。ホスト、ポート、ユーザ、クエリーのテキストは決して含まれません。バックアップ、復元、レポートが失敗したとき、理由は種類として送られます(サーバが文を拒否した、接続が失われた、権限が足りなかった…、エンジンのコードがあればそれも)。サーバのテキストは決して送られません。クエリーやデータを引用していることがあるからで、そのテキストは起きたデバイスに残ります。そしてメッセージは翻訳されて送られるのではありません。送られるのは通知の識別子と生の値で、読む側のデバイスが文を組み立てます。そのデバイスの言語と数値の書式で。だから、フランス語に設定したApple Watchは、Macがスペイン語でもメッセージをフランス語で表示します。読む側のデバイスが古いバージョンで新しい種類の通知を知らない場合は、中に入って届いた代替のテキストを、発行されたときのCalíopeの言語で表示します。翻訳されていないメッセージを目にするのは、このときだけです。

Apple Watchに届いていないとき、このセクションが先に教えてくれます:
- 「メッセージログへの前回の書き込みに失敗したため…」 — ローカルのログが失敗しました。iCloudがオフでも表示されます。まさにそのとき、残っているのはこのログだけだからです。
- 「N件が未アップロード」 — 待ち行列があります。たいていは自然に解消します。
- 前回の同期の失敗を、そのテキストとともに示す通知。

この3つの手がかりがなければ、「Apple Watchに何も表示されない」は、スイッチ、待ち行列、iCloudの失敗、あるいは本当に何も起きていないことのどれでもありえます。見た目はまったく同じで、直し方が違う4つのことです。

誰が読むか:Apple WatchのCalíopeです。Calíopeを動かしているほかのデバイス(Mac、iPad、iPhone、Apple Vision Pro)も自分のログにダウンロードしますが、それを読む画面はありません。Apple Watchでは通知の種類ではなくグループで絞り込みます(19個ではなく7個のスイッチ)。新しい種類の通知は、すでに決めたグループに入ります。

キーワード: メッセージ、システムメッセージ、お知らせ、通知、バックアップ、レポート、SSH、しきい値、保持期間、受信箱、Apple Watch、コンパニオン、iCloud

テレビやApple Watchに何も表示されない

画面が空なのは1つの問題ではなく、いくつもの問題です。原因を順に並べた段階と、ほとんど同じに見えて実は違う3つのケース。

場所: Calíope › 設定 › 一般

Apple TVもApple Watchも、単に「何もありません」とは言いません。それぞれが原因を区別し、どのデバイスで直すかを示します。ほとんどの原因は、見ている場所では直らないからです。ですから、最初の一歩は画面に書かれていることを読むことです。それだけで答えの半分になります。

順に確認する段階。ほとんどの場合、次の5つのどれかです。この順に確認する価値があります:

1. 両方のデバイスで同じiCloudアカウントにサインインしていること。空になっているデバイスの設定で直します。画面にiCloudが制限されていると出る場合、サインインはしています。そのデバイスのスクリーンタイムかデバイス管理がブロックしています。
2. Mac、iPad、iPhone、Apple Vision Proで、Calíopeのチャネルのスイッチがオンであること。チャネルごとにスイッチがあり、どれも最初はオフです。テレビにはサーバ群のスイッチ、Apple Watchにはメッセージのスイッチ。これが最も多い原因です。
3. 受け取る側のデバイス自身の読み取りのアクセス権。Apple Watchにはあり、最初はオフです。テレビにはありません。
4. 一度でも公開されたこと。公開する側のコンピュータが、スイッチを入れた状態で少なくとも一度起動している必要があります。一度も公開していないCalíopeは、公開しているのに報告することがないCalíopeとまったく同じに見えます。
5. 本当に何かがあること。ヘルスモニタが何も監視していなければ、テレビはサーバを表示できません。

紛らわしい3つの画面。ほとんど同じに見えて、意味は同じではありません:

- 「一度も公開されていない」と「メッセージがない」。Apple Watchでは、空の受信箱は良い知らせのことがあります。何も起きていないということです。テレビのパネルでは決してそうではありません。空のヘルスパネルは平穏なパネルと見分けがつかないので、テレビでは額面どおりには受け取りません。
- 「問い合わせできない」。チャネルはありますが、iCloudにインデックスがないか、スキーマがまだこのデバイスに届いていません。あなたの活動に欠けているものはなく、欠けているのは設定です。どのスイッチでも直らないので、私に知らせてください。
- 「N件が途中で失われた」。問い合わせは成功しましたが、読み取りが不完全に戻ってきました。たいていは、もう一度開けば十分です。

そして、不具合ではないもの:Apple Watchで7つのグループをすべてオフにすると、すべてのメッセージが隠れます。Apple Watchは、何も起きていないという良い知らせを伝える代わりに、そのことをそのまま言います。

緑は最新とは限りません。公開する側のコンピュータが自身の更新間隔の3倍(最短でも1分半)を超えて沈黙すると、テレビはデータを古いものとして示します。時刻の古い緑のパネルは、すべて順調だとは言っていません。誰も見ていないと言っているのです。金曜日に電源を切ったMacがそれです。

そして、こちら側から。「設定」›「一般」›「システムメッセージ」には、待ち行列と前回の同期の失敗が表示されます。「Apple TV」のセクションも、サーバ群について同じことをします。ここに待ち行列やエラーがあれば、問題はもう一方のデバイスにはありません。

キーワード: 空、何も表示されない、空白の画面、表示されない、届かない、トラブルシューティング、Apple TV、Apple Watch、iPhone、コンパニオン、iCloud、古い、鮮度

Apple Watchのデモモード

Apple WatchのCalíopeの設定で、スイッチをひとつ入れると、iCloudを読まずに一覧がサンプルのメッセージで埋まります。

Apple WatchのCalíopeの設定で、「デモモード」は一覧を架空のサーバ名のサンプルメッセージで埋め、オンの間、Apple WatchはiCloudを読むのをやめます。

このモードの中には、さらに2つの項目が現れます。空の一覧の画面を集めた「空の画面」と、通知の許可がなければそれを求め、5秒後に通知が届くようにする「テスト通知を送信」です。同じスイッチでオフにします。

キーワード: 時計、Apple Watch、デモ、サンプルのメッセージ、テスト通知