# 在 Laravel Pulse 面板上查看 Hibira 用量

> 一张 Pulse 卡片，把连接数、消息数和发送数据量与套餐上限并列显示，附上跟随 Pulse 时段切换的走势图，以及此刻最活跃的频道。

Source: https://hibira.io/zh-cn/guides/pulse

一张 Pulse 卡片，把连接数、消息数和发送数据量与套餐上限并列显示，附上跟随 Pulse 时段切换的走势图，以及此刻最活跃的频道。

Package: hibira-io/pulse

- 当前连接数和时段内峰值对照套餐上限，今日消息数对照每日上限，让你比用户更早发现快到上限。
- 按订阅人数排序的最活跃频道，用 app 的 key 和 secret 从 Channels HTTP API 读取。
- 不会写入 Pulse 的数据表：每次数值都从 Hibira 获取，并缓存 60 秒。

## 1. 安装

```shell
composer require hibira-io/pulse
```

## 2. 配置

```ini
# A personal API token with read access, from https://hibira.io/portal/api-tokens
HIBIRA_API_TOKEN=hkb_pat_...
HIBIRA_APP_ID=YOUR_APP_ID
# Optional: the key and secret turn on the channel list
HIBIRA_APP_KEY=YOUR_APP_KEY
HIBIRA_APP_SECRET=YOUR_APP_SECRET
```

## 3. 使用

```html
{{-- resources/views/vendor/pulse/dashboard.blade.php --}}
<x-pulse>
    <livewire:hibira.usage cols="6" rows="2" />
    ...
</x-pulse>
```

## 开始之前

- 请把 API token 限定在这个 app，并只给读取权限：卡片不会修改任何东西。
- 如果你的 app 还没有 Pulse 面板的 view，请先运行 php artisan vendor:publish --tag=pulse-dashboard。

- [Packagist](https://packagist.org/packages/hibira-io/pulse)
- [GitHub](https://github.com/hibira-io/pulse)