本文介绍如何快速使用日志服务C++ SDK。
前提条件
已创建RAM用户并完成授权。具体操作,请参见创建RAM用户并完成授权。
已配置环境变量ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET。具体操作,请参见在Linux、macOS和Windows系统配置环境变量。
重要阿里云账号的AccessKey拥有所有API的访问权限,建议您使用RAM用户的AccessKey进行API访问或日常运维。
强烈建议不要把AccessKey ID和AccessKey Secret保存到工程代码里,否则可能导致AccessKey泄露,威胁您账号下所有资源的安全。
已安装C++ SDK安装。具体操作,请参见安装C++ SDK。
示例代码
LOGClient是日志服务的C++客户端,用于管理Project、Logstore等日志服务资源。使用C++ SDK发起日志服务请求,您需要初始化一个Client实例。示例代码如下所示:
#include "client.h"
#include "common.h"
#include <string>
#include <cstdlib>
#include <iostream>
#include <unistd.h>
using namespace aliyun_log_sdk_v6;
using namespace std;
int main(int argc,char ** argv)
{
// 日志服务的服务接入点。此处以杭州为例,其它地域请根据实际情况填写。
string endpoint = "cn-hangzhou.log.aliyuncs.com";
// 本示例从环境变量中获取AccessKey ID和AccessKey Secret。
string accessKeyId = (string)getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
string accessKey = (string)getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
// Project名称。
string project = "";
// Logstore名称。
string logstore = "";
// 日志主题。
string topic = "";
// 日志服务Client。
LOGClient * ptr = new LOGClient(endpoint,accessKeyId,accessKey,LOG_REQUEST_TIMEOUT,"127.0.0.1",false);
// 构造日志数据。
vector<LogItem> logGroup;
for (int i = 0;i < 1;++i)
{
logGroup.push_back(LogItem());
LogItem & item = logGroup.back();
item.timestamp = time(NULL) ;
item.source="127.0.0.1";
item.topic=topic;
item.data.push_back(make_pair<string,string>("status","200"));
item.data.push_back(make_pair<string,string>("latency","126"));
}
try{
// 写入日志。
ptr -> DeleteConsumerGroup(project,logstore,"test-consumer-group");
uint32_t shardId = 2;
int32_t beginTime = time(NULL);
ptr -> PostLogStoreLogs(project,logstore,topic,logGroup);
sleep(1);
ptr -> PostLogStoreLogs(project,logstore,topic,logGroup);
sleep(1);
int32_t endTime = time(NULL);
ptr -> PostLogStoreLogs(project,logstore,topic,logGroup);
sleep(1);
ptr -> PostLogStoreLogs(project,logstore,topic,logGroup);
sleep(1);
// 查询日志。
GetCursorResponse beginCursorResp = ptr->GetCursor(project, logstore, shardId, beginTime);
GetCursorResponse endCursorResp = ptr->GetCursor(project, logstore, shardId, endTime);
GetBatchLogResponse getLogResp = ptr->GetBatchLog(project, logstore, shardId, 1000, beginCursorResp.result);
cout << getLogResp.result.logGroups.size() << "\t" << getLogResp.result.logGroupCount << endl;
getLogResp = ptr->GetBatchLog(project, logstore, 2, 1000, beginCursorResp.result, endCursorResp.result);
cout << getLogResp.result.logGroups.size() << "\t" << getLogResp.result.logGroupCount << endl;
ListConsumerGroupResponse lrs = ptr -> ListConsumerGroup(project, logstore);
for(int i = 0; i < lrs.consumerGroups.size(); ++i)
cout<<lrs.consumerGroups[i].GetConsumerGroupName()<<", " <<lrs.consumerGroups[i].GetTimeoutInSec()<<", " <<lrs.consumerGroups[i].GetInOrder()<<endl;
ptr->UpdateCheckpoint(project, logstore, "hahhah", 0, "V0hBVFRIRlVDSw==");
ListCheckpointResponse lcps = ptr -> ListCheckpoint(project, logstore, "hahhah");
for(int i =0; i < lcps.consumerGroupCheckpoints.size(); ++i)
{
cout<<lcps.consumerGroupCheckpoints[i].GetShard() <<", " << lcps.consumerGroupCheckpoints[i].GetCheckpoint()<<", "<<lcps.consumerGroupCheckpoints[i].GetUpdateTime()<<endl;
}
while(true){
HeartbeatResponse resp = ptr->ConsumerGroupHeartbeat(project, logstore, "hahhah", "cc1", std::vector<uint32_t>());
cout<<"cc1, heartbeat: ";
for(std::vector<uint32_t>::const_iterator it = resp.shards.begin(); it != resp.shards.end(); ++it)
cout<<*it<<", ";
cout<<endl;
resp = ptr->ConsumerGroupHeartbeat(project, logstore, "hahhah", "cc2", std::vector<uint32_t>());
cout<<"cc2, heartbeat: ";
for(std::vector<uint32_t>::const_iterator it = resp.shards.begin(); it != resp.shards.end(); ++it)
cout<<*it<<", ";
cout<<endl;
usleep(2 * 1000 * 1000);
}
}
catch(LOGException & e)
{
cout<<e.GetErrorCode()<<":"<<e.GetMessage()<<endl;
}
delete ptr;
}
更多示例代码,请参见Aliyun Log C++ SDK。