Skip to main content

Bắt đầu với Ogmios

Ogmios là một giao diện cầu nối nhẹ cho cardano-node. Nó cung cấp một WebSockets API cho phép các khách hàng cục bộ nói Ouroboros' mini-protocols thông qua JSON/RPC.

Ogmios không làm được nhiều hơn những gì mà chính node đó làm. Nó khá thấp như những thứ có thể có được với mạng Cardano. Đối với nhiều ứng dụng, mức này quá thấp trong lớp trừu tượng và chúng sẽ tốt hơn nếu sử dụng các dịch vụ cấp cao hơn như cardano-graphql, Rosetta, or Blockfrost.

Giới thiệu​

Cách dễ nhất để bắt đầu với Ogmios là sử dụng docker. Vì Ogmios yêu cầu sự hiện diện của một node Cardano, nên phải sử dụng docker-compose để sắp đặt cả hai dịch vụ. Tệp soạn thảo có sẵn trên kho lưu trữ Ogmios, hãy tải tệp đó qua:

git clone --depth 1 https://github.com/CardanoSolutions/ogmios.git
cd ogmios

Sau đó, bắt đầu các thành phần bằng cách sử dụng:

docker-compose up

Nếu bạn muốn xây dựng mọi thứ từ nguồn hoặc không có docker, vui lòng truy cập Ogmios website.

Dashboard​

Bây giờ bạn có thể truy cập bảng điều khiển trên http://localhost:1337 với hình ảnh trực quan thời gian thực của một số chỉ số thời gian chạy của máy chủ.

img

Truy vấn số liệu​

Bảng điều khiển cung cấp bởi JSON được dùng http://localhost:1337/health.

curl -H 'Accept: application/json' http://localhost:1337/health

Phản hồi:

{
    "metrics": {
        "totalUnrouted": 1,
        "totalMessages": 30029,
        "runtimeStats": {
            "gcCpuTime": 1233009354,
            "cpuTime": 81064672549,
            "maxHeapSize": 41630,
            "currentHeapSize": 1014
        },
        "totalConnections": 10,
        "sessionDurations": {
            "max": 57385,
            "mean": 7057,
            "min": 0
        },
        "activeConnections": 0
    },
    "startTime": "2021-03-15T16:16:41.470782977Z",
    "lastTipUpdate": "2021-03-15T16:28:36.853115034Z",
    "lastKnownTip": {
        "hash": "c29428f386c701c1d1ba1fd259d4be78921ee9ee6c174eac898245ceb55e8061",
        "blockNo": 5034297,
        "slot": 15520688
    },
    "networkSynchronization": 0.99,
    "currentEra": "Mary"
}

Tài liệu về Ogmios​

Để tìm hiểu sâu hơn về Ogmios và cách tương tác với các giao thức mini Ouroboros, hãy truy cậpogmios.dev.